v26.1 paintings pack innit

2026-04-04 08:53:23 -04:00
commit 156be6193f
116 changed files with 1627 additions and 0 deletions
@@ -0,0 +1,90 @@
+# Decocraft Pack Template
+
+Universal resource-only addon pack for Decocraft. No Java code needed.
+Single jar works on both **NeoForge** and **Fabric**.
+
+## Quick Start
+
+1. Clone this repo
+2. Edit `gradle.properties` - change `mod_id`, `mod_name`, `mod_description`, `mod_authors`
+3. Edit `settings.gradle` - change `rootProject.name`
+4. Rename `src/main/resources/assets/decocraft/mypack.json` to your pack name
+5. Update `decocraft.json` to point to your renamed file
+6. Add your content (see below)
+7. `./gradlew build` - jar goes to `build/libs/`
+
+The output jar contains both `fabric.mod.json` and `META-INF/neoforge.mods.toml`,
+so it loads on either mod loader without separate builds.
+
+## Adding Content
+
+For each block you add, you need:
+
+| File | Purpose |
+|------|---------|
+| `mypack.json` | Entry in the `models` array defining the block |
+| `blockstates/{id}.json` | 4 facing variants pointing to block model |
+| `models/block/{id}.json` | Block model referencing bbmodel + texture |
+| `models/item/{id}.json` | Item model referencing item texture |
+| `models/bbmodel/{model}.bbmodel` | BlockBench model file |
+| `textures/block/{id}.png` | Block texture |
+| `textures/item/{id}.png` | Item/inventory texture |
+| `lang/en_us.json` | Display name: `"block.decocraft.{id}": "Name"` |
+
+All assets go under `assets/decocraft/` (the main decocraft namespace).
+
+## Content JSON Entry Fields
+
+```json
+{
+  "name": "Display Name",
+  "model": "bbmodel_filename_without_extension",
+  "material": "texture_name",
+  "scale": 1.0,
+  "tabs": "your_tab_name",
+  "type": "",
+  "crafting_color": [50.0, 50.0, 50.0],
+  "decoref": "unique_block_id"
+}
+```
+
+### Common Types
+
+| type | behavior |
+|------|----------|
+| `""` (empty) | Standard decoration block |
+| `"painting"` | Wall-mounted underlay (no physical block) |
+| `"animated"` | Block with keyframe animations |
+| `"chain"` | Chain/rope entity |
+
+### Optional Fields
+
+- `"hidden": true` - registered but not in creative tabs
+- `"transparency": true` - translucent rendering
+- `"passable": true` - no collision
+- `"script"` - tool_modelswitch, on_use, triggers, particles, etc.
+
+### Model Switching (cycle variants with decobrush)
+
+```json
+"script": {
+  "tool_modelswitch": {
+    "link": "next_variant_id"
+  }
+}
+```
+
+Chain the last variant back to the first to create a cycle.
+
+## Creative Tab
+
+Your `tabs` value becomes a creative tab. Add the tab name to `lang/en_us.json`:
+```json
+"itemGroup.decocraft.your_tab_name": "Decocraft - Your Tab"
+```
+
+## Version Compatibility
+
+Version ranges are open-ended (`>=`), so the pack works with any Decocraft 3.0.7+
+on Minecraft 26.1+. Bump `decocraft_version` in `gradle.properties` if you use
+features from a newer decocraft release.