
Why does your Rust plugin work after reload but fail on restart?
If an Oxide plugin only works after a reload, capture the first failure before fixing it with a second attempt. A reload on an already running server and a clean startup happen at different points in the plugin lifecycle.
Keep two timelines from the same test instance
On an isolated instance with the same versions, start the whole game and save the console from launch until it accepts players. Write down when the affected plugin appears, when its dependencies appear, and when the first error appears. Ask a test player to run the failing action once before reloading anything.
Now reload only the affected plugin and repeat the exact action with the same account and settings. Note what changed in the order or in the dependency state. Use a quiet window on the test instance so a scheduled reload or simultaneous update cannot obscure the sequence.
Read the pair of results
Oxide documents that early initialization can happen before dependencies are available. Its later server-initialized stage also runs for a plugin reloaded after startup.
| What happened | What to investigate |
|---|---|
| Dependency unavailable on startup, present by the later reload | Send the load order and earliest error to the author. Ask whether the plugin supports the dependency at startup. |
| Both versions report loaded, but the same action fails only after startup | Compare the relevant settings, registered permission or prerequisite state at both attempts. Include the first related error after the player action. |
| The plugin is absent after start even though it loaded earlier | Check the active file, startup version and any later unload. Fix the startup condition before adding a scheduled reload. |
Finish with a clean boot
Use the author's supported fix on the test instance. Restart cleanly, wait until the world is ready and repeat the action before anyone reloads the plugin. Keep a cold-start success as the result. If you cannot make the action work without manual intervention, keep the existing live setup while the author investigates.