Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
3a5a8f00bf | ||
|
|
36994f3d0f | ||
|
|
6533e23cc4 | ||
|
|
b2b67384f6 | ||
|
|
c38ba3b394 | ||
|
|
75aa9704b7 | ||
|
|
50da419e9d | ||
|
|
156be6193f |
@@ -1,143 +0,0 @@
|
||||
# Decocraft Pack Template
|
||||
|
||||
Universal 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 and `groups.json`
|
||||
6. Edit `groups.json` to define your creative tabs
|
||||
7. Add your content (see below)
|
||||
8. `./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.
|
||||
|
||||
## File Structure
|
||||
|
||||
```
|
||||
assets/decocraft/
|
||||
decocraft.json - manifest: lists groups.json + your content files
|
||||
groups.json - creative tab definitions
|
||||
mypack.json - block/item definitions
|
||||
models/bbmodel/{model}.bbmodel - BlockBench 3D models
|
||||
textures/block/{material}.png - block textures
|
||||
textures/item/{material}.png - item/inventory textures
|
||||
lang/en_us.json - display names + tab labels
|
||||
```
|
||||
|
||||
All assets go under the `decocraft` namespace.
|
||||
|
||||
Blockstates, block models, item models, item definitions, and loot tables
|
||||
are all generated dynamically at runtime by the main Decocraft mod.
|
||||
You do NOT need to create these files.
|
||||
|
||||
## Per Block Checklist
|
||||
|
||||
For each block you add, you need:
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| `mypack.json` | Entry in the `models` array |
|
||||
| `models/bbmodel/{model}.bbmodel` | BlockBench 3D model |
|
||||
| `textures/block/{material}.png` | Block texture |
|
||||
| `textures/item/{material}.png` | Item texture |
|
||||
| `lang/en_us.json` | `"block.decocraft.{decoref}": "Display Name"` |
|
||||
|
||||
That is it. Everything else is handled automatically.
|
||||
|
||||
## Manifest (decocraft.json)
|
||||
|
||||
Simple array listing files to load. Include `groups.json` first:
|
||||
|
||||
```json
|
||||
[
|
||||
"groups.json",
|
||||
"mypack.json"
|
||||
]
|
||||
```
|
||||
|
||||
Decocraft merges manifests from all jars, so your pack's files are loaded
|
||||
alongside the base decocraft files.
|
||||
|
||||
## Creative Tabs (groups.json)
|
||||
|
||||
Declare tabs with a translation key and icon block:
|
||||
|
||||
```json
|
||||
{
|
||||
"my_tab": { "label": "itemGroup.decocraft.my_tab", "icon": "some_block_id" }
|
||||
}
|
||||
```
|
||||
|
||||
Then add the display name in `lang/en_us.json`:
|
||||
|
||||
```json
|
||||
"itemGroup.decocraft.my_tab": "Decocraft - My Tab"
|
||||
```
|
||||
|
||||
The `icon` must match a block's `decoref` from your content JSON. Tabs from
|
||||
all packs are merged. If the base decocraft already defines a tab key, your
|
||||
blocks will appear in that existing tab.
|
||||
|
||||
## Content JSON Entry
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "Display Name",
|
||||
"model": "bbmodel_filename_without_extension",
|
||||
"material": "texture_name",
|
||||
"scale": 1.0,
|
||||
"tabs": "your_tab_name",
|
||||
"crafting_color": [50.0, 50.0, 50.0],
|
||||
"decoref": "unique_block_id"
|
||||
}
|
||||
```
|
||||
|
||||
### Common Types
|
||||
|
||||
| type | behavior |
|
||||
|------|----------|
|
||||
| (empty/omitted) | Basic decoration block (default) |
|
||||
| `"underlayer"` | Wall/floor mounted virtual overlay (paintings, carpets) |
|
||||
| `"animated"` | Block with keyframe animations |
|
||||
| `"rotatable"` | Block that places at 45 degree increments |
|
||||
| `"bed"` | Sleepable bed |
|
||||
| `"seat"` | Sittable block |
|
||||
| `"chain"` | Chain/rope connector |
|
||||
|
||||
### Optional Fields
|
||||
|
||||
- `"hidden": true` - registered but not in creative tabs
|
||||
- `"transparency": true` - translucent rendering
|
||||
- `"passable": true` - no collision
|
||||
- `"loot": "other_decoref"` - override what drops when broken
|
||||
- `"flipbook": {"frametime": 4, "images": 6}` - animated texture
|
||||
- `"script"` - tool_modelswitch, on_use, sounds, 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.
|
||||
|
||||
## Full Documentation
|
||||
|
||||
See `json_documentation.md` in the main Decocraft mod for the complete
|
||||
field reference with examples of every block type.
|
||||
|
||||
## Version Compatibility
|
||||
|
||||
Version ranges are open ended, so the pack works with any Decocraft 4.0+
|
||||
on Minecraft 26.1+. Bump `decocraft_version` in `gradle.properties` if you
|
||||
use features from a newer decocraft release.
|
||||
@@ -10,14 +10,14 @@ minecraft_version_range=[26.1,)
|
||||
neoforge_loader_range=[4,)
|
||||
fabric_loader_version=0.18.2
|
||||
|
||||
## Mod Properties - CHANGE THESE for your pack
|
||||
mod_id=decocraft_mypack
|
||||
mod_name=Decocraft My Pack
|
||||
## Mod Properties
|
||||
mod_id=decocraft_lighting
|
||||
mod_name=Decocraft Lighting Addon
|
||||
mod_license=All Rights Reserved
|
||||
mod_version=1.0.0
|
||||
mod_group_id=com.razz.decocraft.mypack
|
||||
mod_authors=YourName
|
||||
mod_description=Adds new decorations to Decocraft
|
||||
mod_group_id=com.razz.decocraft.lighting
|
||||
mod_authors=Momo, Razz, ProfMobius, CiciHoneyBee
|
||||
mod_description=Adds lighting decorations to Decocraft
|
||||
|
||||
# Decocraft minimum version
|
||||
decocraft_version=3.0.7
|
||||
@@ -1,6 +1,6 @@
|
||||
distributionBase=GRADLE_USER_HOME
|
||||
distributionPath=wrapper/dists
|
||||
distributionUrl=https\://services.gradle.org/distributions/gradle-9.2.0-bin.zip
|
||||
distributionUrl=https\://services.gradle.org/distributions/gradle-9.0.0-bin.zip
|
||||
networkTimeout=10000
|
||||
validateDistributionUrl=true
|
||||
zipStoreBase=GRADLE_USER_HOME
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
#!/bin/sh
|
||||
|
||||
#
|
||||
# Copyright © 2015-2021 the original authors.
|
||||
# Copyright © 2015 the original authors.
|
||||
#
|
||||
# Licensed under the Apache License, Version 2.0 (the "License");
|
||||
# you may not use this file except in compliance with the License.
|
||||
|
||||
@@ -8,4 +8,4 @@ plugins {
|
||||
id 'org.gradle.toolchains.foojay-resolver-convention' version '0.9.0'
|
||||
}
|
||||
|
||||
rootProject.name = 'decocraft-mypack'
|
||||
rootProject.name = 'decocraft-lighting'
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
[
|
||||
"groups.json",
|
||||
"mypack.json"
|
||||
"lighting.json"
|
||||
]
|
||||
@@ -1,3 +1,3 @@
|
||||
{
|
||||
"mypack": { "label": "itemGroup.decocraft.mypack", "icon": "example_block" }
|
||||
|
||||
}
|
||||
@@ -1,5 +0,0 @@
|
||||
{
|
||||
"itemGroup.decocraft.mypack": "Decocraft - My Pack",
|
||||
"block.decocraft.example_block": "Example Block",
|
||||
"item.decocraft.example_block": "Example Block"
|
||||
}
|
||||
@@ -0,0 +1 @@
|
||||
{"meta":{"format_version":"4.10","model_format":"bedrock","box_uv":false},"name":"lamp_cable_standalone","model_identifier":"","visible_box":[1,1,0],"variable_placeholders":"","variable_placeholder_buttons":[],"bedrock_animation_mode":"entity","timeline_setups":[],"unhandled_root_fields":{},"resolution":{"width":16,"height":8},"elements":[{"name":"lamp_cable_standalone","box_uv":false,"rescale":false,"locked":false,"light_emission":0,"render_order":"default","allow_mirror_modeling":true,"from":[-4.5,4.25,-0.25],"to":[11.5,4.75,0.25],"autouv":0,"color":3,"rotation":[0,0,90],"origin":[0,4.5,0],"faces":{"north":{"uv":[0,0,16,0.5],"texture":1},"east":{"uv":[0,0,0.5,0.5],"texture":1},"south":{"uv":[0,0,16,0.5],"texture":1},"west":{"uv":[0,0,0.5,0.5],"texture":1},"up":{"uv":[16,0.5,0,0],"texture":1},"down":{"uv":[16,0,0,0.5],"texture":1}},"type":"cube","uuid":"fbbc3786-2db7-3deb-160b-6354d70ceb5f"}],"outliner":["fbbc3786-2db7-3deb-160b-6354d70ceb5f"],"textures":[{"path":"C:\\Users\\Gclif\\Downloads\\lamp_cable_standalone_black.png","name":"lamp_cable_standalone_black.png","folder":"block","namespace":"","id":"0","group":"","width":32,"height":16,"uv_width":32,"uv_height":32,"particle":false,"use_as_default":false,"layers_enabled":false,"sync_to_project":"","render_mode":"default","render_sides":"auto","pbr_channel":"color","frame_time":1,"frame_order_type":"loop","frame_order":"","frame_interpolate":false,"visible":true,"internal":true,"saved":true,"uuid":"6db2a266-9263-665f-a5a8-4bacd83886a4","relative_path":"lamp_cable_standalone_black.png","source":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAQCAYAAAB3AH1ZAAAAAXNSR0IArs4c6QAAADRJREFUSEtjtPMI/8+AB7Cxs+OTJij36+dPvGoYCZpAYwWjDhgNgdEQGA2B0RAYDYHREAAAVcME7eyG2IsAAAAASUVORK5CYII="},{"path":"C:\\Users\\Gclif\\Downloads\\lamp_cable_standalone_white.png","name":"lamp_cable_standalone_white.png","folder":"block","namespace":"","id":"0","group":"","width":32,"height":16,"uv_width":32,"uv_height":32,"particle":false,"use_as_default":false,"layers_enabled":true,"sync_to_project":"","render_mode":"default","render_sides":"auto","pbr_channel":"color","frame_time":1,"frame_order_type":"loop","frame_order":"","frame_interpolate":false,"visible":true,"internal":true,"saved":true,"uuid":"21398f9c-bb83-cf59-71a3-21005d6763da","layers":[{"name":"layer","offset":[0,0],"scale":[1,1],"opacity":100,"visible":true,"blend_mode":"default","width":32,"height":16,"data_url":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAQCAYAAAB3AH1ZAAAAAXNSR0IArs4c6QAAADRJREFUSEtjfP369X8GPICdnR2fNEG5nz9/4lXDSNAEGisYdcBoCIyGwGgIjIbAaAiMhgAAkXUG0V5Dk0cAAAAASUVORK5CYII="}],"relative_path":"lamp_cable_standalone_white.png","source":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAQCAYAAAB3AH1ZAAAAAXNSR0IArs4c6QAAADRJREFUSEtjfP369X8GPICdnR2fNEG5nz9/4lXDSNAEGisYdcBoCIyGwGgIjIbAaAiMhgAAkXUG0V5Dk0cAAAAASUVORK5CYII="}]}
|
||||
@@ -1,13 +0,0 @@
|
||||
{
|
||||
"models": [
|
||||
{
|
||||
"name": "Example Block",
|
||||
"model": "example_block",
|
||||
"material": "example_block",
|
||||
"scale": 1.0,
|
||||
"tabs": "mypack",
|
||||
"crafting_color": [50.0, 50.0, 50.0],
|
||||
"decoref": "example_block"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
After Width: | Height: | Size: 1.2 KiB |
|
After Width: | Height: | Size: 1.3 KiB |
|
After Width: | Height: | Size: 1.3 KiB |
|
After Width: | Height: | Size: 293 B |
|
After Width: | Height: | Size: 1.3 KiB |
|
After Width: | Height: | Size: 1.3 KiB |
|
After Width: | Height: | Size: 1.2 KiB |
|
After Width: | Height: | Size: 1.2 KiB |
|
After Width: | Height: | Size: 1.2 KiB |
|
After Width: | Height: | Size: 306 B |
|
After Width: | Height: | Size: 1.2 KiB |
|
After Width: | Height: | Size: 1.2 KiB |
|
After Width: | Height: | Size: 1.2 KiB |
|
After Width: | Height: | Size: 1.2 KiB |
|
After Width: | Height: | Size: 1.3 KiB |
|
After Width: | Height: | Size: 262 B |
|
After Width: | Height: | Size: 1.3 KiB |
|
After Width: | Height: | Size: 1.1 KiB |
|
After Width: | Height: | Size: 518 B |
|
After Width: | Height: | Size: 538 B |
|
After Width: | Height: | Size: 528 B |
|
After Width: | Height: | Size: 189 B |
|
After Width: | Height: | Size: 452 B |
|
After Width: | Height: | Size: 540 B |
|
After Width: | Height: | Size: 157 B |
|
After Width: | Height: | Size: 158 B |
|
After Width: | Height: | Size: 159 B |
|
After Width: | Height: | Size: 158 B |
|
After Width: | Height: | Size: 157 B |
|
After Width: | Height: | Size: 163 B |
|
After Width: | Height: | Size: 158 B |
|
After Width: | Height: | Size: 159 B |
|
After Width: | Height: | Size: 158 B |
|
After Width: | Height: | Size: 159 B |
|
After Width: | Height: | Size: 158 B |
|
After Width: | Height: | Size: 162 B |
|
After Width: | Height: | Size: 163 B |
|
After Width: | Height: | Size: 183 B |
|
After Width: | Height: | Size: 157 B |
|
After Width: | Height: | Size: 183 B |
|
After Width: | Height: | Size: 158 B |
|
After Width: | Height: | Size: 157 B |
|
After Width: | Height: | Size: 158 B |
|
After Width: | Height: | Size: 159 B |
|
After Width: | Height: | Size: 184 B |
|
After Width: | Height: | Size: 157 B |
|
After Width: | Height: | Size: 163 B |
|
After Width: | Height: | Size: 158 B |
|
After Width: | Height: | Size: 159 B |
|
After Width: | Height: | Size: 158 B |
|
After Width: | Height: | Size: 159 B |
|
After Width: | Height: | Size: 158 B |
|
After Width: | Height: | Size: 162 B |
|
After Width: | Height: | Size: 163 B |
|
After Width: | Height: | Size: 183 B |
|
After Width: | Height: | Size: 157 B |
|
After Width: | Height: | Size: 183 B |
|
After Width: | Height: | Size: 158 B |
|
After Width: | Height: | Size: 112 B |
|
After Width: | Height: | Size: 112 B |
|
After Width: | Height: | Size: 582 B |
|
After Width: | Height: | Size: 585 B |
|
After Width: | Height: | Size: 573 B |
|
After Width: | Height: | Size: 582 B |
|
After Width: | Height: | Size: 584 B |
|
After Width: | Height: | Size: 278 B |
|
After Width: | Height: | Size: 120 B |
|
After Width: | Height: | Size: 579 B |
|
After Width: | Height: | Size: 585 B |
|
After Width: | Height: | Size: 584 B |