Wiki

Standards

These rules keep the planning docs consistent and trustworthy.

Status: Active

These rules keep the planning docs consistent and trustworthy.

Status Labels

Use one status per page:

  • Active: living reference page that defines current process or contract rules
  • Draft: early notes, not yet stable
  • Source-backed: supported by current research
  • Planned: chosen direction for implementation
  • Implemented: matches code or pack assets in the repo
  • Blocked: waiting on research, tooling, or compatibility work

Decision Status Labels

Use these labels in Decision Register:

  • Locked: approved for review and implementation planning
  • Open: unresolved and should be treated as a real design question
  • Later: intentionally deferred and not a blocker for the first implementation pass

Documentation Rules

  • Record whether a claim is source-backed, design translation, or assumption.
  • If a page mentions Minecraft loader, mod version, or server workflow, include the exact version target.
  • If a page summarizes inspiration-source content, prefer grouped progression data over unstructured item dumps.
  • If research is incomplete, say so directly.
  • Put non-negotiables in Project Contract, not only in scattered prose.
  • Put every meaningful Locked, Open, or Later call in Decision Register.
  • Treat Phase Registry, Core Ladders, and Pack Baseline as canonical over one-off mentions in other pages.
  • When implementation changes phase scope, update Phases and Architecture.
  • When a phase gets its own detail page, update Phase Registry and link it from Phases.

Inspiration Handling

  • Inspiration pages may use source names.
  • Core design pages should prefer original project names and terms.
  • If a direct source mechanic is adopted, document the translation, not just the source reference.
  • Do not use source names for final boss, relic, mount, weapon, or set naming unless the thing is a vanilla Minecraft material or creature that should stay recognizable.

Phase Rules

Each implementation phase should feel playable on its own.

Each phase must define:

  • Goal
  • Biome or structure scope
  • Materials and crafting loop
  • Armor slice
  • Class-valid weapon support
  • Boss or gate
  • Quest flow
  • Multiplayer considerations
  • Definition of done

Version Lock Discipline

Until changed intentionally, the planning baseline is:

  • Minecraft: 1.21.1
  • Loader: NeoForge
  • Distribution: CurseForge
  • Server panel: Crafty

If the project moves versions, update these pages first:

Naming Conventions

  • Phase names use Phase NN - Name
  • Pages should prefer singular nouns for systems and plural nouns for grouped catalogs
  • Content pages should link back to Home
  • Detailed phase pages should live under docs/wiki/phases/
  • Player-facing system terms should use the project glossary in Glossary

Texture Style Rules

Custom textures should stay visually native to Minecraft.

  • Preserve vanilla-style pixel readability and material clarity
  • Stay close to vanilla detail density instead of drifting into noisy or painterly surfaces
  • Favor simple shading, readable silhouettes, and restrained contrast
  • New blocks, items, and mobs should look like they belong beside vanilla assets without calling attention to a different art pipeline
  • If a design idea only works with a radically different texture style, rework the design instead of breaking the visual language

Anti-Clone Rules

  • Do not document direct 1:1 ports as if they were final design.
  • Every major feature inherited from Necesse or Terraria must be filtered through Minecraft terrain, mob ecology, and survival readability.
  • Existing Minecraft mobs should be remixed before entirely replacing the world with unrelated enemy rosters.
  • Mounts, relics, and events should feel native to this project, not like renamed imports with unchanged behavior.

Non-Goals

These docs should not:

  • Pretend every source page has been fully inventoried when it has not
  • Mix implemented behavior with wishlist ideas without labeling them
  • Lock in pack mods as final before compatibility testing