Giter VIP home page Giter VIP logo

jotunn's Introduction

JotunnLib

Banner

Jötunn (/ˈjɔːtʊn/, "giant"), the Valheim Library was created with the intent to facilitate developer creativity, unify the communities problem solving efforts, and enhance developer productivity by curating a library of common helper utilities, as well as interfaces and abstractions which aid with mod interoperability. networked gameplay consistency, and remove the need to maintain valheim version specific code by acting as an interface between the developer and the games changing internals.

This project was originally derived from the base structure of JötunnLib, and had many entity abstractions and features from ValheimLib merged into it before we proceeded with further implementations. We have lots of features planned for the future, and we hope the community has many feature requests to suggest. I hope the features we have implemented thus far prove to be a useful base and provide an idea of the consistency we aim to deliver moving forwards.

Usage

Please refer to our documentation. We have gone to great lengths to ensure there is ample documentation to facilitate the developers learning experience.


Features

JVL provides three distinct groups of features. Entities, which abstract the game's own entities into easy-to-use interfaces. Managers, which act as interfaces between the entities and native collections or subsystems. Utilities, which are there to aid in generic/common functions that can span many different areas.

Entities

  • CustomItem - Represents ingame items such as weapons, tools and consumables.
  • CustomRecipe - Represents ingame recipes for managing crafting and upgrading of items.
  • CustomPiece - Represent ingame building pieces.
  • CustomStatusEffect - Represents ingame status effects from weapon hit effects to guardian powers.
  • CustomItemConversion - Represents ingame item conversions for the CookingStation, Fermenter and Smelter in one abstraction.
  • Mocks - Fake any vanilla prefab and use it in your custom assets - Jötunn resolves the references to the vanilla objects at runtime.
  • Config classes - There are many more abstractions beside the main entities which allow for easy creation of things like key bindings, custom commands, skills and more.

Managers

  • Command Manager - Facilitates implementation of methods which can be registered as executable console commands.
  • GUI Manager - Allows invocation of UI prefabs on the fly via code.
  • Input Manager - Provides an interface for binding keys via ZInput in a consistent manner, facilitating custom keybind hints.
  • Item Manager - Abstracts away implementation details of configurations applied to items/recipes to provide a consistent developer experience in adding new items. tl;dr items are easy!
  • Localization Manager - Provides multiple methods of loading localisation data into the game, as well as exposing an interface for adding additional languages to provide localizations to unsupported languages.
  • Piece Manager - Very similar to the Item Manager, abstracting implementation details of configurations for pieces/recipe's.
  • Prefab Manager - Provides a cache of prefabs registered through other managers, mostly developers will only query the cache for prefabs added via other managers.
  • Skill Manager - Facilitates additional custom skills.

Utilities

  • Asset Helpers - Methods to facilitate referencing and loading of assets.
  • Bone Reorderer - Fixes bone ordering issues on SkinnedMeshRenderer's that have been ripped and imported into unity.
  • NetworkCompatibility - Allows plugins to define their own version requirements for clients connected to the server. Ensures a customisable level of interoperability with clients of differing mod configurations on a plugin-by-plugin basis.
  • Config Synchronisation - Allows administrators to adjust configuration values via an in game menu. Config setting is synced to connected clients.
  • SimpleJSON - We have imported SimpleJSON into our library at the request of developers who would simply prefer to have this dependency taken care of already. We use the MIT Licensed SimpleJSON

Roadmap

  • v1.1.0
    • Facilitate custom adjustment of bone attachments
    • Provide a more meaningful and interopable solution to mod interopable keybindings (resolve mod bind conflicts/standardise an interface)
    • TODO: cooking recipes?!??! this is not currently possible?
    • Implement item variations into codable enmtity abstractions to minimise asset workflow.
    • Custom piecetable category/tabs
    • Check our v1.1 milestones for a more up to date list of features currently in development, or suggest your own features for inclusion by creating a new feature request

Bugs, Support, Contributions

Please refer to our documentation before requesting support via discord. If there are any mod interoperability issues developers experience (not just exclusive JVL issues), we would like to hear from you! If we can facilitate better mod interoperability by providing a common interface, or exposing native valheim objects, including a utility which you have created, then please feel free to create a new feature request or pull request.

Changelog

  • v1.0.0
    • Merged VL's Entity abstractions: CustomItem, CustomPiece, CustomRecipe
    • Implemented JL's Entity Configs into the Custom abstractions
    • Merged VL's runtime FixReference resolver into JVL, split out MockManager to be responsible for prefabs that it resolves.
    • Merged VL's Localization implementation into JVL
    • Refactored JL's patch system to use Monomod's hookgen.
    • Deprecated JL's EventManager in favour of Monomod's event subscriptions (Why implement a feature that already exists?)
    • Refactored JL's and VL's recipe interfaces to provide a consistent developer experience by generalising requirements and providing consistently named abstraction interfaces to piece and item collections.
    • Implemented GUIManager, which facilitates usage of Synchronised configurations
    • Implemented NetworkCompatibility attribute.
    • Implemented custom keybind/hints

Contributors to Jötunn, the Valheim Library

These people have been integral to pushing JVL out of the door, and without them we could not have achieved nearly as much. Please give them some love on github, thunderstore, and nexus.

Core:

iDeathHD#7866: github, thunderstore

Algorithman#6741: github

Jules#7950: github

Quaesar#5604: github

radu#0571: github, thunderstore, nexus

paddy#1337: github, thunderstore, nexus

Contributors:

Cinnabun#0451: github

GoldenJude#8965: github, nexus

zarboz#7828: github, thunderstore, nexus

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.