Healthy DietFEATURE GUIDEEnglish
09 / SERVER ADMIN

Server administration and synchronization

Distinguish authoritative server rules, client-only display files and startup-time item registration before changing configuration.

server.jsonDatapack overridesReload and sync
Paths: Unless stated otherwise, the paths here are relative to the game or server instance. Installed files and server configuration determine the actual behavior.

01Current configuration locations

Path under config/healthy_diet/Responsibility
server.jsonServer gameplay, privacy and shelf-life stack-merge thresholds.
display.jsonClient display settings, not the sole source of gameplay switches.
colors/color_schemes.json / colors/solid_colors.jsonGradients and solid-color palette.
fatigue/fatigue_gradient.json / fatigue/fatigue_exempt.jsonFatigue styling and foods exempt from recovery counting.
shelf_life/schemes/Shelf-life display schemes; related seasonal and temperature configuration has separate current paths.
bottle_fills.json / fog_effects.jsonFluid source filling / local client fog distances.
item_rarities.jsonItem-level rarity fallback.
quality_registry/*.jsonStartup-time definitions of separate registered items.
Old server_privacy.json and shelf_merge.json moved into sections of server.json. Old config/healthy_diet/items/, tooltips/ and blocks/ are not current datapack locations.

02Datapack definitions and local overrides

Items, tooltips, nutrition groups/stages/bonuses, quality, rarity and block rules use datapacks. The HD-local override root is config/healthy_diet/datapack/data/<namespace>/healthy_diet/<type>/<file>.json. For an item, inspect data/<namespace>/healthy_diet/items/<itemPath>.json; tooltips use tooltips/, quality uses quality_levels/, blocks use blocks/. Confirm which pack supplies an entry before editing; deleting a top-layer override can expose a lower-priority definition instead of disabling the item.

03What /hdreload does

/hdreload (OP4) rereads Healthy Diet reloadable configuration and its disk override layer, then resends authoritative content to online players. It is not Minecraft’s full /reload. Some editor saves already trigger a mod reload. After modifying an override, inspect command feedback (including loaded/discarded block-variant counts) and test a real item or block. World datapacks and other mods follow their own reload procedure.

/hdconfig is a client-local command requiring OP4 to invoke; it is not registered on a dedicated-server console. Non-OP players may still reach their local appearance settings through other screens.

04Changes requiring another procedure

  1. New registered item IDs: registry definitions take effect at startup. Distribute identical definitions and resources to client/server and restart.
  2. Local client files: display.json, local gradients and fog settings are not forcibly reread by a server /hdreload.
  3. Stack limits: changing an item-level stack-size property requires restart; different NBT variants cannot have different stack sizes.
Successful synchronization of one server rule does not mean clients have received a newly registered item ID or local resource.

05Common commands and permission levels

CommandPermission / purpose
/hdhelpEveryone: command index with hover help; clicking only fills chat.
/headietEveryone: own panel. Viewing another: OP2; modifying nutrients: OP4. clearaversion: OP2.
/hdinfo [item]Everyone: matching main-hand variant, or a default stack for explicit item ID; opens a local viewer.
/hdtemperatureEveryone: current temperature sources and details.
/hdtrustEveryone: own protected-item trusted-player list.
/hdui / /hdui createOP4: held-item editor / nutrition group, quality and rarity definitions.
/hdui stage / /hdui groups [player]OP4: stage and bonus editor / player-value management.
/hdui tooltip / /hdui registryOP4: tooltip entry / startup registered-item management.
/hdset rarityOP2: set or clear an item rarity.
/hdcloneitem / /hdreloadOP4: selective off-hand→main-hand config copy / HD-only reload.
/hdconfigClient-local OP4 command; unavailable on dedicated-server console.
/titlepro and relatedOP2: title, template, table, clear and color overlay.
/cleartoastSelf: no OP; another player: OP2.

Use /hdhelp in your installed version for exact parameters rather than copying historical permission tables.

06Optional integrations

Optional modFeature
JadeShelf-life information for supported dropped foods.
Legendary Survival OverhaulAvailable world temperature and perceived-temperature data.
Ecliptic SeasonsSeason, climate, temperature and preservation integration.
Refurbished FurnitureRefrigerator/freezer preservation; NeoForge also requires its framework.

These are optional per-feature integrations, not prerequisites for basic play; check the third-party mod’s availability for your game version.

For a field-by-field guide and illustrative in-game UI, continue to Configuration reference.