Skip to content
SilentChaos512 edited this page Dec 27, 2024 · 21 revisions

Welcome to the Silent-Gear wiki! Below are two sections, one with pages that should be useful for those just playing with the mod, the other for those who are creating a mod/data pack.

For Players

  • Starter Guide (Silent Gear 4)/(Silent Gear 3) - An incomplete walkthrough, but it will get you started and answer some common questions
  • Blueprint Package - You may have spawned with this
  • Gear Classes - Descriptions of most gear items which can be crafted
  • Parts - A list of part types and their purposes
  • Repairing Gear - How to repair your tools, weapons, and armor (repair kits)
  • Synergy - Mixing materials for additional bonuses (OUTDATED, but still useful)
  • Grades - Grading and the material grader (formerly "part analyzer")
  • Stats - I recommend players at least skim over the list of stats
  • Traits - A list of traits, those things that many materials have
    • Extended Trait List - Generated with several add-on mods installed. May not be updated as regularly as the main list.
  • Blueprint Book - Efficient storage for blueprints
  • Commands - List of available commands (BADLY OUTDATED!)
  • Starlight Charger (NEW!) - Gives big stat bonuses to materials
  • Supercharger (Silent's Gems) - Supercharging parts greatly increases their stats

For Mod/Pack Makers

Pages useful for anyone creating a mod, mod pack, or data pack. Remember to check the log file if things are not working out! If Silent Gear is unable to read a file you created, it will tell you why it failed, giving you clues of how to fix it.

For Mod Developers

(1.21 and beyond)
Silent Gear now uses registries for anything not directly loaded from a JSON file. Part types, gear types, trait effect types, and more are now registries. Simply create a DeferredRegister with the appropriate registry in SgRegistries and register your new objects!

(Original text)
If you want to add new parts or traits with your mod, the process is very similar to creating a data pack. Just create the part/trait JSON files and make sure they are in the correct location.

If you are adding a new part type or none of the existing trait types do what you need, you will need to register a new serializer for them. See the register method in PartSerializers and TraitSerializers. Creating a new part type as soon as your mod begins constructing should also register the serializer for you. The concept is very similar to vanilla's recipe serializers and the like.

When Something Goes Wrong...

Check Your Logs!

Because it's worth saying a second time. The logs will give you clues when something fails. Don't forget to load a world first, as most files are loaded after the world starts loading, same as other data pack resources.

Silent Gear should never crash (keyword being should) because of malformed JSON files. Such files will either be ignored or partially loaded, to whatever extent the mod is able to do so.

Missing Parts/Traits, Cannot Craft Gear

This lovely bug is caused when something goes wrong when loading data files, usually in another mod. This causes all files that would have loaded after the error to not load, including files from unrelated mods.

You can identify the problem by searching your log file for "Failed to reload data packs". The stacktrace after that will usually mention the offending mod.

Or If All Else Fails...

You can ask me on my Discord server: https://discord.gg/Adyk9zHnUn. Please do not direct message (DM) me. But you will get a response to questions in the #silent-gear or tech-support channels.

If your are sure something is actually broken or you feel it could be improved, open a new issue on the issue tracker. Issues are the best way to ensure bugs get fixed.