ShadowCustomizer Models

The address this server is known by from the outside. Only the licence needs it. Empty is fine for almost everyone.

The language used when the player's own is not available. The plugin ships en_US and it_IT; a file you add to lang/ is picked up too.

Every player reads the messages in their own client language, when that file exists.

The namespace of the models. It MUST match models.namespace in ShadowCustomizer's config: that is what ties "shadow:sword" written in an item definition to the file inside the pack. If the two do not match, the client cannot find the model and draws the purple and black missing-model cube.

The pack_format, that is, which Minecraft version this pack is for.

Getting it wrong makes the client reject the ENTIRE pack, silently: it is the first place to look when "the pack will not load".

88 is the value for 1.26.2. It changes with every Minecraft version, and the way to know it for certain is to read it from the server itself: inside the version's jar there is a version.json with a "pack_version", and the number you want is "resource_major".

What you read in the client's resource pack list.

If you already have a resource pack of your own, put the path of its UNPACKED folder here - the one containing pack.mcmeta. The builder will copy yours first and only write on top of it what it adds.

Who wins when a file in pack-extra/ has the same path as a file the plugin generates (a model, the note_block blockstate, an item definition).

false: the generated one is kept, and the console tells you which
       file it was. Right for almost everyone.
true:  yours replaces it, and the console says that too. Careful:
       replacing a generated model breaks the items that use it.

Adding the files of pack-extra/ is part of the merge, a Premium feature.

The full link clients download the pack from.

LEAVE IT EMPTY unless you upload pack.zip somewhere yourself: then the built-in server below serves it and the link is worked out on its own. Write it when you host the pack elsewhere (a website, a CDN, a shared host that gives you no port for the built-in server): it always wins over everything else. After every build, upload the new pack.zip again.

Rebuild the pack on every start.

True is almost always right: a server coming back up should find the pack already up to date, and asking an administrator to type a command after every restart is exactly the loop that makes resource packs go stale. The build runs off the game thread and does not slow the start-up down.

Send the pack to whoever joins.

True out of the box: custom items and blocks without their pack look wrong, and the point of this extension is that players see them with nothing to configure. The pack goes out with its SHA-1 hash, so a player who already has it does not download it again. Whoever joins while the pack is still being built right after a restart gets it as soon as it is ready.

It is a Premium feature.

Whether players MUST accept the pack.

false: they can decline and play without it (they will see the
       custom items as the material they are made of).
true:  the game only offers "accept" or "disconnect".

The text on the download screen is not here: it is the key pack.prompt in lang/<language>.yml, so every player reads it in their own language. Empty ('') means no text.

On out of the box: it is what gets the pack to your players with nothing configured. Turn it off only if you upload pack.zip yourself and write its link in pack.url.

Where the pack is served.

auto            the Minecraft port when players reach this server
                directly; its own port (server.port, below) when a
                proxy sits in front, when public-address below
                carries a port other than the Minecraft one (the
                port you forwarded for the pack server), or when
                this server does not let plugins share its port.
                Right for almost everyone: the console says which
                one it picked.
minecraft-port  always the Minecraft port (server-port in
                server.properties). Nothing to open.
own-port        its own small web server on server.port, as up to
                version 1.0.2.

- a BungeeCord or Velocity proxy in front: players connect to the
  proxy, not here. auto notices it (bungeecord in spigot.yml,
  velocity or proxy-protocol in config/paper-global.yml) and uses
  its own port;
- a DDoS protection service in front (TCPShield and the like) that
  only lets Minecraft traffic through. That one cannot be seen from
  here: set own-port and open server.port, or upload pack.zip
  somewhere and use pack.url.

The port of the pack's own server (TCP), used by own-port - and by auto when it falls back to it. It is NOT the Minecraft port.

Which network interface the pack's own server listens on (own-port). Empty means all of them, which is what you want nearly every time. On the Minecraft port it is Minecraft's own: server-ip in server.properties.

Players on the same computer or the same home network as the server get a local link (127.0.0.1 or the 192.168.x.x address) instead of the public one: almost no home router lets you reach your own public IP from inside, so the download would fail for you and for anyone playing from your house. Players from outside keep getting the public link. Set false only if a proxy on this same machine hides the players' real addresses (then everybody looks like 127.0.0.1).

The address to put in the download link.

1. server.bind above, if it is a public IP;
2. server-ip in server.properties, if it is a public IP;
3. asking the internet (public-ip-lookup below);
4. this machine's address on the local network - that works only
   for players on the same network, and the console warns you.

Ask the internet for this server's public IP, when nothing above gives it.

Once at start and after /scmodels reload, in the background, a few seconds at most. It is a plain HTTPS request to the services below, which answer with the IP they see: nothing about your server is sent. It is skipped when public-address or pack.url is written, or when server-ip is already public.

false = never ask: the link then uses the local-network address, unless you write public-address.

Who to ask, in order: the next one is tried if one does not answer. Any service that answers with the bare IP works. The default is the ShadowMC licence service (the same as license.activation-url), which answers with the address it sees and nothing else.

The base address of the activation service. The plugin appends /claim and /check on its own.

This is OUR service and it is filled in for you: buying and activating have to be the same gesture. Left empty - which is how this file shipped until 20/09/2026 - "/scmodels license claim <code>" has nobody to ask, and a paying customer is left holding a code that does nothing. Change it only if you run your own copy of the service.

How many days the plugin keeps working after the service stops answering. It is not generosity: a subscription that just renewed, a DNS hiccup or an outage on our side must never take Premium away from someone who paid.

Asks the activation service above (activation-url + /ip) how this server looks from outside: it answers with the address it sees, and nothing about the server is sent. It is the only way a machine behind a NAT can know the address its players use. Only when a licence is installed: a server without a key asks nobody. false = never ask.

The three draw stages. Without this line the bow stays still while you draw it: the pack knows only one model and the game draws that one. The thresholds are vanilla's, so it bends with the rhythm of every other bow - a different rhythm gets noticed, and it gets noticed as a defect.

A crossbow needs six: three for charging, plus unloaded, loaded with an arrow and loaded with a rocket.

The blocking pose. Without it, the raised shield looks the same as the lowered shield.

Ordinary models, declared like any other. They are never worn on their own: the entries above name them, and the pack says when to draw each.

They are listed apart because that is what they are - frames of an animation, not items - and because a bow set has three of them and it would bury the weapon it belongs to.