Getting started¶
Install¶
- You need a Paper 26.1.2 server running Java 25.
- Download
MegaOrbitals-<version>.jarfrom the releases page. - Put it in your server's
plugins/folder and start (or restart) the server. - The plugin creates
plugins/MegaOrbitals/with: config.yml, the main settings (Configuration)configs/, one settings file per cannonlang/en.yml, every message
Fire your first cannon¶
As an operator, look at a block and run:
A targeting ring and beam appear for a couple of seconds, then the strike lands.
Replace classic with any cannon id. /orbital list and /orbital search <word> help you find one,
and CANNONS.md lists them all.
If you didn't mean to do that, /orbital undo puts the blocks back.
Browse the cannons¶
This opens a chest menu with every cannon. The bottom row has:
- arrows for the previous and next page
- a category button (explosives, mobs, terrain...)
- a tier filter (common, rare, epic, legendary)
- a search box
- a counter showing how many cannons match
Click a cannon to take its item (shift-click for 16). This needs megaorbitals.give.
Cannon items¶
Anyone holding a cannon item can right-click to call the strike on the block they are looking at.
By default the item is used up. Set items.consume-on-use: false to make items reusable.
Give items with:
Normal players can fire items (megaorbitals.use is on for everyone) but can't use /orbital or /orbitalgive.
See Commands and permissions.
Make it survival-friendly¶
Out of the box, only operators can get cannons. For a survival server you might:
- Let players craft cannons. Orbital Cores are craftable, and right-clicking a core gives a random cannon of its tier. Bosses drop cores too. See Features → Tiers, crafting and drops.
- Add cooldowns. Use
cooldowns.item-seconds, pluscooldowns.per-cannonfor the big ones. - Turn on satellites. Players then need a charged satellite over the target to fire. See Features → Satellites.
- Disable the cannons you don't want. List them in
cannons.disabled. - Protect builds. Set
safety.allow-block-damage: false(no cannon changes blocks) orrollback.auto-restore-seconds(terrain repairs itself after a strike).