Home - moonfather1/workshop_for_handsome_adventurer GitHub Wiki

Wiki home

Welcome to the workshop for handsome adventurer wiki!

This won't be a comprehensive manual for the same reason that there is no in-game help - if I need to explain a bookshelf, I made a lousy bookshelf.

There are some things, however that need explanation, most importantly tags and magical support for modded wood, so here we go:

Item tags

Vanilla

  • minecraft:bookshelf_books (located at data/minecraft/tags/items/bookshelf_books.json) Added by Mojang in 1.20, this controls what items can go into those chiseled bookshelves. Obviously this mod allows everything from this tag onto its bookshelves. As a rule, modders should add readable books into this tag and also forge:books (c:books from 1.21 onwards). Non readable books (enchantments, etc.) should only go into later tag.

Forge specific

  • forge:books (located at data/forge/tags/items/books.json) Workshop uses this tag to tell what can go onto the bookshelf. If a modder forgot to add their manual to this tag, you need to add it. This isn't Workshop's tag, it existed long before it and is used for other things.
  • forge:workbench (same path) Used for crafting recipes that use crafting tables as ingredient. You need not add anything to this one. But if you are making a recipe that uses a crafting table, use this tag instead of a crafting table item.

Neoforge/fabric

  • c:books (located at data/c/tags/item/books.json) Workshop uses this tag to tell what can go onto the bookshelf. If a modder forgot to add their manual to this tag, you need to add it. This isn't Workshop's tag, it existed long before it and is used for other things.
  • c:player_workstations/crafting_tables (located at data\c\tags\item\player_workstations\crafting_tables.json) Used for crafting recipes that use crafting tables as ingredient. You need not add anything to this one. But if you are making a recipe that uses a crafting table, use this tag instead of a crafting table item.

Workshop's own tags

  • workshop_for_handsome_adventurer:allowed_on_potion_shelf (located at data/workshop_for_handsome_adventurer/tags/items/allowed_on_potion_shelf.json) This tells us what can go onto the potion shelf. For things that aren't potions, but are fluid bottles from other mods, you may want to add them to this tag. Honey bottles are used as an example in the tag (you can remove those from tag, they don't really fit the theme).
  • dont_allow_onto_toolrack (same path) Controls what can or can not go onto toolrack. In general, this mod can't tell for arbitrary item whether it's a tool or not. Sure, we can recognize pickaxes, swords, etc. but some random non-stackable item - we can't tell.
  • dont_rotate_on_toolrack (same path) Items in this tag are hung vertically on toolracks. Non-tool items that are not in this tag are rotated by 45 degrees on toolrack.
  • larger_on_toolrack_125_percent (same path) Items in this tag are a little larger on toolrack.
  • larger_on_toolrack_150_percent (same path) Items in this tag are a noticeably larger on toolrack.
  • lanterns (same path) Tells us what items are accepted by dual table to give it internal light. Try it, it will save you some room.
  • supported_planks (same path) Contains planks that can give us our crafting tables in 2x2 configuration. Absent planks give vanilla crafting table. This is used if an option to craft our tables directly is turned on.

Configuration

This mod has four config files. Yes, everyone makes that same face when they see a mod having more than two config files...

The two that don't have "special" in their name are normal forge config files. The other two (special ones) are for the auto-support system for modded wood. The thing is - mod needed config early; much earlier than forge config becomes available. That is why there are these "special" config files.

common.toml

Normal forge config. Same for all players.

  • You can (and should) set the mod to replace vanilla crafting table recipe - you craft workshop's tables from 2x2 planks. Normal table is craftable from ours if necessary.
  • You can set the number of customization slots for tables. Default number of slots allows for half of all customizations. You can increase this if you don't like having to choose customizations.

client.toml

Normal forge config. Client settings - each player can set them differently.

  • Set whether you want the crafting ingredient left in tables to be rendered on table tops.
  • Set whether you want detailed info about things in toolracks and bookshelves when hovering with jade/wthit/top.

special-common.json

(located in workshop subdirectory as of 1.21.1)

Config for auto-support system for modded wood. Normal forge config isn't available during block registration and it's a good thing it isn't - it shouldn't be. Except we needed it so... Anyway, details are on the next page (link below).

special-client.json

(located in workshop subdirectory as of 1.21.1)

Same as above.

Support for various wood types

separate page