85 lines
1.9 KiB
Markdown
85 lines
1.9 KiB
Markdown
# 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:
|
|
|
|
```text
|
|
https://mc.ahmza.com/playground/dev/pack.toml
|
|
```
|
|
|
|
The Pterodactyl server should normally use:
|
|
|
|
```text
|
|
PACKWIZ_AUTO_SYNC=1
|
|
```
|
|
|
|
so restarting Playground synchronises it with the latest published pack.
|
|
|
|
## Development
|
|
|
|
Playground changes can normally be committed directly to `main`:
|
|
|
|
```bash
|
|
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.
|