# ⁉️ Questions & Answers

## Compatibility and setup

<details id="does-the-plugin-support-bedrock-versions">

<summary>Does the plugin support Bedrock players?</summary>

Yes, through Geyser. The player menus open as native Bedrock forms, and a menu button with several click actions asks Bedrock players which one to run, so Shift actions in the editor work too. Opening animations that use player heads only show once the skulls are registered in Geyser. See [GeyserMC (Bedrock)](../../configurations/geysermc-bedrock.md).

</details>

<details id="do-the-gui-animations-work-for-bedrock-players">

<summary>Do the GUI animations work for Bedrock players?</summary>

Yes. Opening animations are the same for Bedrock and Java players. The rewards preview, reward selection, confirmation, reroll and virtual keys menus open as Bedrock forms when Floodgate or Geyser is installed on the same server, and players can switch back to chest menus with `/crates forms`. See [Bedrock forms](../../configurations/geysermc-bedrock.md#bedrock-forms).

</details>

<details id="how-do-i-allow-bedrock-users-view-animations-that-include-skulls">

<summary>How do I show animations that use skulls to Bedrock players?</summary>

Bedrock cannot load player head textures on its own. Register every head in Geyser's `skin-hashes` option, following the [Geyser custom skulls guide](https://geysermc.org/wiki/geyser/custom-skulls/). The hashes for every animation are listed under [Bedrock skull textures](../../configurations/geysermc-bedrock.md#bedrock-skull-textures).

</details>

<details id="is-phoenixcrates-folia-compatible">

<summary>Is PhoenixCrates Folia compatible?</summary>

Yes, both the free and the Premium version. Commands run as the player, from rewards or from `[COMMAND] player` actions, work there too. An opening ends when the player leaves the crate's world, `/tp` included, the same as on Paper.

</details>

<details id="why-isnt-the-newest-minecraft-version-supported-yet">

<summary>Why isn't the newest Minecraft version supported yet?</summary>

A new release is added once it has settled, so there is a gap between launch and support. PhoenixCrates is usually one of the first of our plugins to get it. There is no ETA, and updates are free for life. The current list is on [Version Support](../../first-installation.md#version-support).

</details>

<details id="can-the-plugin-run-as-a-forge-or-fabric-mod">

<summary>Can the plugin run as a Forge or Fabric mod?</summary>

No, there is no mod version. Hybrid servers such as Arclight or Mohist can load it, but we do not recommend them, and faults caused by the hybrid itself are not plugin issues.

</details>

<details id="does-the-plugin-work-without-internet-access">

<summary>Does the plugin work without internet access?</summary>

The Lite version works offline; only server statistics, update notices and server linking need our servers. Premium checks its license with our servers, so it needs outbound internet access; see [What happens on startup](https://www.phoenixplugins.com/docs/phoenix-plugins/licensing#what-happens-on-startup).

</details>

<details id="which-files-do-i-copy-to-another-server">

<summary>Which files do I copy to another server?</summary>

Copy `crates/`, `keys/`, `menus/`, `translations/`, `config.yml`, `internal_storage.yml`, `rarities.yml` and the add-on configuration files. Add `locations.yml` if the worlds come along; a location in a world the new server does not have is skipped.

Player progress (virtual keys, cooldowns, opened counts, win limits) lives in the database, so point the new server at the same MySQL database or bring the SQLite file. Every file is described on [File Structure](../../configurations/crate-configuration-file.md#file-structure).

> **Warning:**
A license only allows a limited number of servers at once. Check [Licensing](../licensing.md) before running both.

</details>

## Crates and models

<details id="why-my-crates-can-only-be-open-by-op-players">

<summary>Why can only operators open my crates?</summary>

The crate sits inside spawn protection. Set `spawn-protection` to `0` in `server.properties` and protect the area with a region plugin such as WorldGuard instead.

</details>

<details id="whats-the-difference-between-attachcrate-and-placecrate">

<summary>What is the difference between attachCrate and placeCrate?</summary>

**`/crates attachCrate <crate_id>`** turns the block you are looking at into the crate and keeps its look, so a chest, a barrel or part of a build can become a crate. `/crates detachCrate` undoes it.

**`/crates placeCrate <crate_id> <world> <x> <y> <z> [facing]`** places the crate at exact coordinates. Nothing has to be there and you do not have to be nearby, which makes it the one for the console and setup scripts. Premium only.

For dungeon or minigame instances, add `temporary` at the end: the crate works as normal but is not saved, so it is gone after a restart. Remove it when the instance closes with **`/crates removeCrate <world> <x> <y> <z>`**. A crate copied along with a build or schematic is only a block; place the crate in each copy with these commands.

Both need their permission. Placing a crate item by hand needs `phoenixcrates.admin`. See [Permissions](../permissions.md#placing-and-removing-crates).

</details>

<details id="how-do-i-use-a-custom-model-as-the-crate-block">

<summary>How do I use a custom model as the crate block?</summary>

Pick the model through the crate's engine, not by placing the item: [Vanilla Model](../../main-features/crate-engine-mode/README.md#vanilla-model), [Model Engine](../../main-features/crate-engine-mode/README.md#model-engine) or [Better Model](../../main-features/crate-engine-mode/README.md#better-model), depending on where the model comes from. In the free version, right-click the engine item (the experience bottle) to change it.

</details>

<details id="why-my-custom-models-are-not-being-displayed-correctly">

<summary>Why is my custom model displayed wrong?</summary>

**Scrambled model.** A resource pack manager such as ItemsAdder, Oraxen or Nexo is merging Model Engine files into its own pack. Keep Model Engine resources out of that pack so custom model data does not collide.

<figure><img src="../../.gitbook/assets/image (33).png" alt=""><figcaption></figcaption></figure>

**Too small or too large.** The Vanilla Model engine shows models on an armor stand head. Open the model in Blockbench, go to the Display tab and adjust the head size.

<figure><img src="../../.gitbook/assets/image (15).png" alt="" width="563"><figcaption></figcaption></figure>

</details>

<details id="why-my-custom-model-from-model-engine-keep-flickering">

<summary>Why does my Model Engine model keep flickering?</summary>

A region with mob spawning turned off, usually a WorldGuard flag, stops Model Engine models from loading properly. Allow mob spawning in the crate's region.

</details>

<details id="can-i-change-the-scale-of-a-bettermodel-crate-model">

<summary>Can I change the scale of a Better Model crate model?</summary>

Yes, from the Better Model editor.

</details>

<details id="how-do-i-check-the-animations-of-my-custom-model">

<summary>How do I find the animation IDs of my custom model?</summary>

Open the `.bbmodel` file in Blockbench and switch to the Animate tab at the top right. The animation IDs are listed on the left.

</details>

<details id="why-my-furniture-models-are-being-destroyed-when-clicked">

<summary>Why are my furniture models destroyed when clicked?</summary>

Furniture models are not supported directly. With the Vanilla Model engine, convert the furniture into an item with custom model data.

</details>

## Opening crates

<details id="why-does-my-crate-take-the-key-but-say-it-cant-be-opened">

<summary>Why does my crate take the key but say it cannot be opened?</summary>

Another plugin fires the interaction twice, so the crate opens on the first call and refuses the second. Remove plugins one by one to find the one duplicating it.

</details>

<details id="why-does-my-crate-say-there-are-no-rewards-available">

<summary>Why does my crate say there are no rewards available?</summary>

The crate has rewards, but none this player can win right now. Check the reward settings:

* The reward is **disabled**.
* The player holds one of its **Restricted Permissions**, or misses one of its **Required Permissions**.
* Its **Win Limit** or **Global Win Limit** has been reached.
* A **Win Limit Cooldown** or **Global Win Limit Cooldown** is still running.
* It is **time limited** and the window has passed.

With [Rarity](../../add-ons/rarity/) installed, also check that the **rarity is enabled** and that the key's rarities **match** at least one reward.

Trying the crate as an operator on a fresh account narrows it down: if it works there the cause is a permission, otherwise a limit or a cooldown.

</details>

<details id="can-a-player-open-a-crate-with-a-full-inventory">

<summary>Can a player open a crate with a full inventory?</summary>

Only with [Crate Claim](../../add-ons/crate-claim/README.md). Without it the player is told the inventory is full and no key is taken. With it the crate opens and whatever does not fit is stored for `/crate claim`. Keys, crates and rewards given by command follow the same rule: dropped at the player's feet without the add-on, stored with it.

</details>

<details id="why-am-i-told-my-data-is-still-loading">

<summary>Why am I told my data is still loading?</summary>

The player's record has not come back from the database yet, and the crate refuses to open rather than read a stale key count. It clears within a second. If it happens all the time, the database is the bottleneck: check that MySQL is reachable, then raise `fetch-timeout` or `maximumPoolSize` in the [connection pool](../../configurations/main-configuration.md#connection-pool).

</details>

<details id="what-is-the-difference-between-your-chance-and-percentage-in-the-preview">

<summary>What is the difference between "Your Chance" and "Percentage" in the preview?</summary>

**Percentage** is the weight the server owner gave the reward. Several rewards can share it. **Your Chance** is the real probability for that player, and all of them add up to 100%. Two rewards set to 100% each give a 50% chance each.

</details>

<details id="do-reroll-groups-stack">

<summary>Do reroll groups stack?</summary>

No. Only the matching group with the highest count applies, so a player in a default group worth 2 and a VIP group worth 10 gets 10. Groups do add to the other sources:

```
free rerolls + best matching group + rerolls given with /crates giveReroll
```

Mass Opening multiplies the total by the number of keys used. Details on [Reroll](../../features/reroll.md#how-the-total-is-calculated).

</details>

## Keys and rewards

<details id="why-doesnt-an-offline-player-receive-the-key-i-gave-them">

<summary>Why doesn't an offline player receive the key I gave them?</summary>

Physical keys given to an offline player wait on the server and are given the next time they join; with [Crate Claim](../../add-ons/crate-claim/README.md) installed they go to the player's claim storage instead. Virtual keys are added to their balance straight away.

</details>

<details id="why-doesnt-my-key-show-in-the-virtual-keys-menu">

<summary>Why doesn't my key show in the virtual keys menu?</summary>

`/crates virtualKeys` only lists a key that is set to **Virtual**, is **enabled**, and that the player owns **at least one** of. A new key stays hidden until you give yourself one with `/crates giveKey`. The menu is customized in [Customize Menus](../../configurations/customize-menus.md#virtual-keys-menu).

</details>

<details id="will-renaming-a-crate-or-reward-lose-player-progress">

<summary>Will renaming a crate, key or reward lose player progress?</summary>

Changing an **identifier** does. The database ties progress to it, so the old records point at nothing:

* **Crate** - open cooldowns, opened counts and rerolls.
* **Key** - every player's virtual keys of that key.
* **Reward** - win counts and win limit cooldowns.
* **Rarity** - the rarity link on every reward and key using it.

Display names are safe to change at any time. Settle identifiers before a crate goes live.

</details>

<details id="how-can-i-create-a-reward-where-the-player-doesnt-receive-a-physical-item">

<summary>How do I make a reward that gives no physical item?</summary>

Leave the reward item as display only and give the benefit with [win commands](../../main-features/rewards/win-items-and-commands.md), such as a voucher or currency. PlaceholderAPI can randomize the amounts.

</details>

<details id="how-do-i-remove-the-amount-of-the-item-won-from-the-hologram">

<summary>How do I remove the amount from the reward hologram?</summary>

Edit `crate.reward-got` in `translations/translations.en.yml` and remove `&ex%amount%`:

```yaml
crate:
  reward-got: '&a%reward%'
```

<figure><img src="../../.gitbook/assets/image (73).png" alt=""><figcaption></figcaption></figure>

</details>

<details id="why-when-using-the-chat-from-the-editor-there-are-color-to-the-value">

<summary>Why do values typed in the editor chat get a color?</summary>

A chat color or prefix plugin is formatting the message before the editor reads it. Disable that plugin's chat color, or edit the value in the crate file.

</details>

## License and purchase

<details id="why-does-my-license-say-maximum-concurrent-sessions">

<summary>Why does my license say maximum concurrent sessions reached?</summary>

The same license key is active on more servers than your plan allows, usually after copying the plugin to every server behind a proxy. See [Sessions](https://www.phoenixplugins.com/docs/phoenix-plugins/licensing#sessions) on the licensing page.

</details>

<details id="do-you-offer-refunds">

<summary>Do you offer refunds?</summary>

No. A downloaded product is not refundable. See point 7 of the [Terms and Conditions](https://www.phoenixplugins.com/terms-and-conditions).

</details>

Source: https://www.phoenixplugins.com/docs/phoenix-crates/plugin-information/questions-and-answers