Files
mcpacks/playground/README.md
T

1.9 KiB

Playground

Playground is the experimental Minecraft environment.

Unlike Forever World, this pack is intentionally disposable and exists for testing mods, updates and configuration changes without risking the permanent world.

Purpose

Use Playground for:

  • evaluating new mods
  • testing major mod updates
  • testing Minecraft/NeoForge upgrades
  • experimenting with world generation
  • testing compatibility between mods
  • testing configuration changes
  • reproducing crashes
  • validating potential Forever World changes

The world may be reset or replaced at any time.

Platform

The Minecraft and NeoForge versions may change depending on what is being tested.

Packwiz remains the source of truth for the pack.

Deployment

Development builds are published at:

https://mc.ahmza.com/playground/dev/pack.toml

The Pterodactyl server should normally use:

PACKWIZ_AUTO_SYNC=1

so restarting Playground synchronises it with the latest published pack.

Development

Playground changes can normally be committed directly to main:

cd playground

packwiz add <mod>
packwiz refresh

git add .
git commit -m "Test <mod> in Playground"
git push

Feature branches may be used for larger experiments, but are not required for routine testing.

Promotion to Forever World

A mod working in Playground does not automatically make it suitable for Forever World.

Before promotion consider:

  • stability
  • maintenance activity
  • compatibility
  • world-save impact
  • dependencies
  • performance
  • removal behaviour
  • future Minecraft upgrade prospects

Mods considered suitable should then be added independently to the Forever pack and tested against the Forever staging server.

Persistence

Nothing in Playground should be considered permanent.

Worlds, configs and mods may be removed or reset as required.

If something matters, move it into the appropriate version-controlled configuration before relying on it.