From c2e6a3a3c71e240616e325f11cc705cf3f8258ea Mon Sep 17 00:00:00 2001 From: benny Date: Sat, 22 Nov 2025 23:34:20 +0000 Subject: [PATCH 1/2] Update README.md --- README.md | 111 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 111 insertions(+) diff --git a/README.md b/README.md index e69de29..8ac3b95 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,111 @@ +🎒 1. datapacks/ — Minecraft’s built-in modding system + +Datapacks are Minecraft's official way to add game logic without mods. +They let you create custom: + +Recipes + +Loot tables + +Structures + +Commands/functions + +Dimensions + +Advancements + +Worldgen features + +Mobs (via loot, behavior triggers, etc.) + +They live inside: + +world/datapacks/ + + +or in a custom world folder of your choice. + +Example structure: + +world/ + datapacks/ + my_custom_pack/ + pack.mcmeta + data/ + minecraft/ + mypack/ + + +How they work: + +When the server starts, Minecraft automatically loads all datapacks in that folder. + +You can reload them live with: + + +/reload + +Why track them in Git? + +Because datapacks are basically tiny “mods” made out of text files. +Git lets you: + +Version your changes + +Roll back bad ideas + +Experiment + +Collaborate + +Deploy from laptop → server instantly + +Keep a history of your custom world logic + +For a Vanilla 1.1 server, datapacks didn’t exist yet — BUT if you're doing a modern-style organization or planning forward, Git still handles it well. + + + +🌍 2. dev-world/ — A safe test world + +This is NOT a built-in Minecraft feature — it’s a practice/testing world folder that YOU create. + +Purpose: +👉 To test datapacks, commands, NBT edits, worldgen changes, and dangerous experiments without ruining the real world. + +What it looks like: + +dev-world/ + level.dat + region/ + playerdata/ + + +Basically the same as your real world/, but: + +You can reset it anytime + +You can duplicate it + +You can try insane commands + +You can prototype datapack functionality + +You can test structures/commands with no consequences + +How to use it: + +You temporarily point your server to use dev-world instead of world. + +In server.properties: +level-name=dev-world + + + + +Start the server → it loads the dev world. +When you’re done testing, switch back: + +level-name=world + From 4c67b77508b0089a9c24f34afa6d231e0c47f8d4 Mon Sep 17 00:00:00 2001 From: benny Date: Sat, 22 Nov 2025 23:36:35 +0000 Subject: [PATCH 2/2] Update README.md --- README.md | 125 +++++++++++++++++++++++++++--------------------------- 1 file changed, 62 insertions(+), 63 deletions(-) diff --git a/README.md b/README.md index 8ac3b95..ce7d220 100644 --- a/README.md +++ b/README.md @@ -1,33 +1,30 @@ -🎒 1. datapacks/ — Minecraft’s built-in modding system +# 📦 Datapacks & Dev-World Overview -Datapacks are Minecraft's official way to add game logic without mods. -They let you create custom: +## 🎒 1. `datapacks/` — Minecraft’s Built-In Modding System -Recipes +Datapacks are Minecraft’s **official way to add custom game logic** without installing mods. +They allow you to create: -Loot tables +- 🍲 Recipes +- 🎁 Loot tables +- 🗺 Structures +- ⚙️ Commands/functions +- 🌌 Dimensions +- 🏆 Advancements +- 🌱 Worldgen features +- 👾 Mob behavior (via loot/function triggers) -Structures - -Commands/functions - -Dimensions - -Advancements - -Worldgen features - -Mobs (via loot, behavior triggers, etc.) - -They live inside: +Datapacks live inside: +``` world/datapacks/ +``` +(or inside any other world folder you choose). -or in a custom world folder of your choice. - -Example structure: +### 📁 Example Structure +``` world/ datapacks/ my_custom_pack/ @@ -35,77 +32,79 @@ world/ data/ minecraft/ mypack/ +``` +### ⚡ How Datapacks Work -How they work: - -When the server starts, Minecraft automatically loads all datapacks in that folder. - -You can reload them live with: - +- When the server starts, Minecraft **automatically loads** all datapacks in that folder. +- You can reload them live with: +``` /reload +``` -Why track them in Git? +### 🧠 Why Track Datapacks in Git? -Because datapacks are basically tiny “mods” made out of text files. -Git lets you: +Because datapacks are basically **tiny mods made from text files**, Git gives you: -Version your changes +- Full version control +- Rollbacks for bad experiments +- A safe way to iterate +- Easy syncing between machines +- A complete history of every change -Roll back bad ideas +> **Note:** Minecraft 1.1 did not support datapacks yet — but this structure is useful for future worlds or modern servers. -Experiment +--- -Collaborate +## 🌍 2. `dev-world/` — A Safe Testing Sandbox -Deploy from laptop → server instantly +`dev-world/` is **not** a built-in Minecraft feature. +It’s a folder **you create** to safely test changes without risking the real world. -Keep a history of your custom world logic +### 🎯 Purpose -For a Vanilla 1.1 server, datapacks didn’t exist yet — BUT if you're doing a modern-style organization or planning forward, Git still handles it well. +Use this sandbox world to test: +- Dangerous commands +- Datapack functionality +- Worldgen changes +- NBT edits +- Anything experimental +### 📁 Example Structure -🌍 2. dev-world/ — A safe test world - -This is NOT a built-in Minecraft feature — it’s a practice/testing world folder that YOU create. - -Purpose: -👉 To test datapacks, commands, NBT edits, worldgen changes, and dangerous experiments without ruining the real world. - -What it looks like: - +``` dev-world/ level.dat region/ playerdata/ +``` +This mirrors your real `world/` folder. -Basically the same as your real world/, but: +### 💡 Why a Dev World? -You can reset it anytime +- Reset it instantly +- Duplicate it whenever needed +- Safely break anything +- Prototype new features +- Avoid griefing or corrupting the main world -You can duplicate it +### 🔧 How to Use `dev-world/` -You can try insane commands +In your `server.properties`, set: -You can prototype datapack functionality - -You can test structures/commands with no consequences - -How to use it: - -You temporarily point your server to use dev-world instead of world. - -In server.properties: +``` level-name=dev-world - - - +``` Start the server → it loads the dev world. -When you’re done testing, switch back: +When you're finished testing, switch back: + +``` level-name=world +``` +---