API overview
Working Java MarketAPI in plugin 1.0.3 and the planned, non-existent HTTP API.
Based on GrzybcioRynek 1.0.3 and web 0.1.0 source.
In 1.0.3 there is only a Java API for other plugins on the same Paper server. There is no HTTP or webhook layer.
What works
| Surface | Status | Package / file |
|---|---|---|
MarketAPI | works | com.example.marketplace.api.MarketAPI |
| Bukkit events | work | com.example.marketplace.api.event |
| PlaceholderAPI | optional | identifier grybciorynek |
| HTTP REST | 🚧 Planned | no code |
| Webhooks | 🚧 Planned | no code |
MarketAPI.init is called in finishEnable() after storage and MarketManager are assembled. Before that isReady() is false.
Details: Java MarketAPI, Events.
What does not exist
There is no HTTP server in the plugin. Strona/ is a Next.js 0.1.0 mock — api.ts reads mock.ts, not the plugin.
Web login: localStorage key grzybciorynek.session. No auth tokens, server sessions, or webhooks.
Endpoint proposal (not implemented): Planned HTTP API.
Threads
Mutations sellItem / removeListing must run on the server main thread. Otherwise:
IllegalStateException: MarketAPI mutacje muszą być wywoływane z głównego wątku serweraPlugin not ready:
IllegalStateException: GrzybcioRynek API nie jest gotowe