Development

Development

Building

From the Salamander repository, run:

./gradlew build

The build runs the unit tests on the build JVM and Java 8.

Resource-pack regression tests

To include the original-pack regression tests, download these ZIPs separately and keep their filenames:

• Fresh Animations 1.10.5: FreshAnimations_v1.10.5.zip

• Fresh Animations: Spiders 2.2: FA+Spiders-v2.2.zip

• Just Expressions 1.2.1: JustExpressions_v1.2.1.zip

• Fresh Moves 3.1 with eyes: -1.21.2 Fresh Moves v3.1 (With Animated Eyes).zip

• Fresh Moves 3.1 without eyes: -1.21.2 Fresh Moves v3.1 (No Animated Eyes).zip

• Fresh Moves 3.1.1 with eyes: +1.21.3 Fresh Moves v3.1.1 (With Animated Eyes).zip

• Fresh Moves 3.1.1 without eyes: +1.21.3 Fresh Moves v3.1.1 (No Animated Eyes).zip

• Cozy Critters 1: cozy-critters-1-19-4.zip

Set SALAMANDER_CEM_PACK_DIR to the directory containing the files:

SALAMANDER_CEM_PACK_DIR=/path/to/packs ./gradlew build

These optional tests exercise all 114 Fresh Animations models, its model-selection rules, and the spider extension across animation frames. When the Just Expressions ZIP is present, they also check its wide and slim models, facial geometry, and animations. The Fresh Moves checks exercise both player sizes across movement states, overlay alignment, native arm poses, static hands, and body variables shared with capes and elytra. Cozy Critters checks exercise its original random-texture rules, including weighted variants and baby/biome conditions. The packs are not bundled with Salamander.

See Custom entity models for supported targets, configuration, and adding compatibility for other backports.

Debug models

Set debug.debugMode=true in config/salamander/salamander.cfg on the client and server, then restart.

The sampler cycles through the creeper, bat, render-layer, NPC, magma-spider, and jester models when right-clicked. Sneak-right-click to go backward.

/summon salamander.debug_model ~ ~ ~
/summon salamander.debug_citadel_fly ~ ~ ~
/summon salamander.debug_citadel_dragon ~ ~ ~