MMOContentWorkspace - Folders, Shared Config & Recipe Files

MMOContentWorkspace
Organize by dungeon. Reuse shared settings. Review what changes.

Maintaining a growing MMOItems pack often means editing large type files and copying the same settings between items. MMOContentWorkspace lets you author smaller files in folders, inherit shared configuration and keep each station recipe separately. It compiles standard MMOItems YAML with a source map.

Included in 1.0

• Nested item folders with stable TYPE:ID identities.
• Shared configuration inheritance with recursive map merge, list replacement and cycle detection.
• One recipe per file, compiled into native station files.
• Validation for YAML, duplicate IDs, missing parents and station references.
• Native YAML export, source origins and reviewable change plans.
• Optional whole-file managed publication with backups, conflict checks, rollback and interrupted-write recovery.
• English and Chinese messages; editable training item and station examples.

First use on an existing server

1. Extract the download, put the JAR in plugins and restart. Run /miworkspace init.
2. Edit plugins/MMOContentWorkspace/source/.
3. Run /miworkspace validate, then /miworkspace export.
4. Back up the relevant native file and merge exported item blocks by ID. Copy new station files only after checking their IDs are unused.
5. Run /mi reload on a test server and verify the generated items and recipes.

Do not replace an existing sword.yml with a one-item example export. Export is the default. Managed apply is opt-in and only owns entire files which are absent or already managed. Existing unmanaged files are refused.

Source layout
Commands
Alias: /miws. All commands require mmoworkspace.admin (operators by default). Console supported. Reload affects this addon only; MMOItems reload remains separate.

Requirements and validation
No client mod or resource pack. Build target: Spigot API 1.20.4 / Java 17 bytecode. Tested with Java 21, Paper 1.21.4 and 1.21.8, MMOItems 6.10.1-SNAPSHOT and MythicLib 1.7.1-SNAPSHOT. The example item and station were loaded by native MMOItems; the 1.21.8 check crafted and collected the recipe result. Compiler/publisher tests: 26 passed, one Windows symlink test skipped.

Compilation/export can run without MMOItems. Applying into MMOItems requires the enabled plugin. Dependencies are not bundled. Internal changes in other development builds need separate validation.

Version 1 scope
Native fields pass through. This is not complete validation of every MMOItems stat, formula or integration. It does not import existing files, synchronize native GUI edits, register custom types or delete obsolete generated files. External edits invalidate publication plans. No player inventories or item NBT are changed.

The ZIP includes the JAR, full English/Chinese README and configuration references.

Feedback
Use Discussion for bug reports and workflow requests. Include exact server, Java, MMOItems and MythicLib versions and a small redacted example. An honest review after trying it is welcome.