> For the complete documentation index, see [llms.txt](https://lethium.gitbook.io/origin-smp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lethium.gitbook.io/origin-smp/troubleshooting.md).

# Troubleshooting

Symptoms and fixes: startup and licences, origins, stacking, menus and icons, placeholders, economy and fishing.

Find your symptom, try the fix, and if it is still wrong read the console. **Most problems leave a line in the console** with a plugin name or a file name.

## Startup and licences

| Symptom                                                                                            | Cause and fix                                                                                                                                                                                                                         |
| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A plugin disables itself right after start                                                         | Its licence was refused. Look for a `License ...` line in the console and see [Licensing](/origin-smp/getting-started/licensing.md).                                                                                                  |
| `License check timed out, disabling plugin.`                                                       | The server could not reach `license.lethium.net` within 30 seconds. Check the machine's internet and firewall.                                                                                                                        |
| `... is still starting up. Please wait a moment.`                                                  | The licence check is still running. Wait a few seconds. If it does not go away, look for a licence line in the console.                                                                                                               |
| StackMaster has no `license.key` in its `config.yml`                                               | Add the `license:` section yourself. See [Installation](/origin-smp/getting-started/installation.md).                                                                                                                                 |
| OriginSurvival does not enable, error mentions `dev/aurelium/auraskills` or `NoClassDefFoundError` | AuraSkills is not installed. Install it. See [Hooks](/origin-smp/originsurvival/hooks.md).                                                                                                                                            |
| A YAML error naming a file and line                                                                | A tab, a missing quote or bad indentation. Open that file at that line. Lists with a star must be quoted: `["*"]`, never `[*]`.                                                                                                       |
| `Error occurred while enabling <plugin>`                                                           | Scroll up to the first error of that plugin. Usually a missing dependency or a broken file.                                                                                                                                           |
| ItemsAdder, OriginSurvival or FastAsyncWorldEdit refuse to load                                    | The server jar is Folia or Canvas. The setup as shipped needs Paper until OriginSurvival has Folia support and ItemsAdder is replaced by Nexo or gets Folia support. See [Requirements](/origin-smp/getting-started/requirements.md). |

## Origins

| Symptom                                     | Cause and fix                                                                                                                                      |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| The origin menu does not open on first join | `roll.first-join.enabled` is false, or `action` is not `OPEN_GUI`. Players can always open it with `/origin`.                                      |
| A player cannot roll                        | They have no free rolls left and cannot pay, they are on cooldown, or `roll.mode` is `PICK`. See [Rolling](/origin-smp/originsurvival/rolling.md). |
| An origin never comes up in rolls           | It is disabled under `origins:` or has no weight. Run `/origin validate`.                                                                          |
| Origin icons are slime balls                | The resource pack is not loaded. The icons are `SLIME_BALL` with custom model data from the Origin SMP pack.                                       |
| A small origin has a huge name tag          | Turn on `nametag.scale-fix`. See [Chat and name tags](/origin-smp/originsurvival/chat-and-nametags.md).                                            |
| Level-up rewards were skipped               | When one XP gain jumps several levels, only the last level's `level-commands` run. `/origin setlevel` runs none. Give the missed rewards by hand.  |
| An ability does nothing                     | It is listed in `features.disabled-abilities`, or `features.abilities` is off. See [Abilities](/origin-smp/originsurvival/abilities.md).           |
| My config change has no effect              | Run `/origin reload`. Then `/origin validate` to see if the value was rejected.                                                                    |

## Stacking

| Symptom                                           | Cause and fix                                                                                                                                                                    |
| ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Wild mobs do not stack                            | Expected: `stacking-entities.natural-spawns.stack: false`. Mobs from spawners, breeding and eggs still stack. See [Entity stacking](/origin-smp/stackmaster/entity-stacking.md). |
| A mob type never stacks                           | It is on the blacklist, its per-mob limit is off, or the world is in `disabled-worlds`.                                                                                          |
| Stacks stop growing at a number                   | A per-mob cap (for example zombies 200) or `general.global-max-stack-size` is lower than the stack's own `max-stack-size`. The lowest one wins.                                  |
| Jobs, quests or MobCoins count one kill per stack | Kills inside a stack do not fire a normal death event for each mob. See [Compatibility](/origin-smp/stackmaster/compatibility.md).                                               |
| `/sm give` shows a bare message key               | The message is missing from your `config.yml`. Add it. See [Commands and permissions](/origin-smp/stackmaster/commands-permissions.md).                                          |
| A setting has no effect                           | Some keys in the default file are not read by the plugin. [config.yml](/origin-smp/stackmaster/config-yml.md) marks each of them.                                                |
| `falling back to SQLite` at start                 | The database you set could not be reached. See [Storage](/origin-smp/stackmaster/storage-and-sync.md).                                                                           |

## Menus, icons and the HUD

| Symptom                                       | Cause and fix                                                                                                                                                                                     |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Icons are squares, plain items or slime balls | The resource pack did not load or is stale. Check `self_host` in ItemsAdder's config, run `/iazip` in game, rejoin. See [ItemsAdder and the HUD](/origin-smp/server-setup/itemsadder-and-hud.md). |
| `/iazip` from the console fails               | Run it in game once the server has finished starting.                                                                                                                                             |
| The HUD sits low on the screen                | Boss bars added before the HUD push it down. Keep BetterHud's `merge-boss-bar: false`.                                                                                                            |
| Raw `&#RRGGBB` codes in a message             | That plugin does not read hex codes in that place. See [Chat, TAB and menus](/origin-smp/server-setup/chat-tab-menus.md).                                                                         |

## Placeholders

| Symptom                              | Cause and fix                                                                                                                 |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
| `%originsurvival_...%` shows as text | PlaceholderAPI is missing, or `hooks.placeholderapi` is false.                                                                |
| Empty value                          | The player has no origin, or that system is off. See [Placeholders](/origin-smp/originsurvival/placeholders.md).              |
| The `[gems]` chat tag shows text     | `chat-tags.gems.display` in LPC's `config.yml` must use `%excellenteconomy_balance_raw_gems%`. PlayerPoints is not installed. |
| Test any placeholder                 | `/papi parse me <placeholder>`                                                                                                |

## Economy and fishing

| Symptom                             | Cause and fix                                                                                                                                                                     |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| No FarmCoins from the harvester hoe | WildTools must be installed and enabled at startup. See [Economy lanes](/origin-smp/originsurvival/economy.md).                                                                   |
| Lane coins stop for the day         | The daily cap was reached. See [Economy lanes](/origin-smp/originsurvival/economy.md).                                                                                            |
| Players catch only vanilla fish     | Check `allowed-worlds` and `allowed-regions` in EvenMoreFish's `config.yml`: `[]` means everywhere. Then `/emf admin reload`. See [Fishing](/origin-smp/server-setup/fishing.md). |
| A scheduled key-all does nothing    | The crate name in `zSchedulers/schedulers.yml` does not match a CrazyCrates crate. The command is `crazycrates giveall virtual <crate> 1 -s`.                                     |

## Commands that do not work for players

| Symptom                                              | Cause and fix                                                                                                                              |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Works for you, not for players                       | Operators pass every permission check. Test with a normal account and check the `default` group in LuckPerms.                              |
| `Unknown command` or no permission for players       | The `default` group lacks the permission. See [Ranks and kits](/origin-smp/server-setup/ranks-and-kits.md) and the plugin's commands page. |
| A crate or console command fails with "players only" | `/origin souls give` only works from a player. Use another reward for console commands.                                                    |
