**Turn every vote into progress.**
Players vote on server lists, and every vote counts toward **8 permanent ranks**, from **Cog** to **Industrialist**. Each rank gives real perks: more homes, more claim chunks, coins, flight in the Shop and a growing set of cosmetics. The top ranks can upload their own **capes, skins and wings**, like the Essential mod, into permanent slots.
Built for **Create Economy**, in a Create brass-and-andesite style.
---
### β¨ Features
- π³οΈ **Votes from server lists:** works with **Modded Votifier** (v1 and v2), so Minecraft-MP, MinecraftServers.org, Planet Minecraft and any other Votifier site count.
- π
**8 permanent ranks:** votes add up for good, and nobody loses a rank.
- π **More homes:** works with Hub Essentials' `/home` menu, from 6 homes up to 20.
- πΊοΈ **More claim chunks:** added to the **player's own** FTB Chunks data, so they stay with the player when they join or leave a party.
- π° **Coins at every rank-up:** Numismatics coins and Shop Expansion Tokens, paid once when you reach each rank (votes themselves don't pay).
- ποΈ **Shop flight:** nobody can fly in the Shop world (elytra, jetpacks and other mods' flight are stopped), except ranks that get `/fly` there.
- π·οΈ **Rank nametags:** `[Rank] name β` above your head, in chat and in the tab list, in your chosen colour, with a badge.
- π¨ **Cosmetics:** name colours, nametag badges, particle trails, 6 Create-themed capes, Andesite and Brass wings, floating hats (cogs, propellers, a nether star...) and back items (a spinning cog, backtanks, a propeller).
- πΌοΈ **Your own capes, skins and wings:** like the Essential mod, but earned. Capes unlock at Conductor, skins (normal or slim arms) at Architect, wings at Industrialist. Each upload fills a permanent slot (1, 2 and 3 slots).
- π« **Cosmetic mods blocked:** players running mods like Figura, Ears, Essential, MinecraftCapes, CustomSkinLoader or Custom Player Models are refused, so cosmetics come from ranks only.
- π΄ **Offline votes count:** votes made while offline are counted at the next join, and any rank-up rewards are paid then.
---
### π The ranks
| Rank | Votes | Homes | Extra claims | Rank-up reward | Uploads | Extras |
| --- | --- | --- | --- | --- | --- | --- |
| **Cog** | 5 | 6 | +10 | 1 cog + 1 token | – | Tag, green name, β badge |
| **Shaft** | 15 | 7 | +20 | 2 cogs + 1 token | – | Spark trail, Cog Halo, Andesite cape |
| **Gearbox** | 35 | 8 | +35 | 4 cogs + 1 token | – | **Shop flight**, Big Cog back item |
| **Mechanic** | 60 | 10 | +50 | 1 crown + 2 tokens | – | Propeller hat, backtank, Copper cape |
| **Engineer** | 100 | 12 | +70 | 2 crowns + 2 tokens | – | Join message, flame trail, Brass cape, Andesite wings |
| **Conductor** | 150 | 14 | +90 | 3 crowns + 2 tokens | 1 slot: **capes** | Soul fire trail, Railway cape |
| **Architect** | 225 | 17 | +115 | 4 crowns + 3 tokens | 2 slots: **+ skins** | End rod trail, Blueprint cape, Brass wings |
| **Industrialist** | 325 | 20 | +150 | 1 sun + 4 tokens | 3 slots: **+ wings** | Totem trail, Nether Star hat, Industrialist cape |
Rewards are paid once per rank, never per vote. All numbers, rewards, cosmetics, upload ranks and vote links are in one config file.
---
### π₯οΈ The Ranks screen
`/ranks`, `/vote` and `/cosmetics` open one screen with:
- **Header:** your face, rank tag, total votes, votes this month and a progress bar to the next rank.
- **Rank:** all 8 ranks as a ladder. Click one to see its homes, claims, upload slots, flight and perks.
- **Cosmetics:** name colour, badge, trail, cape, wings, hat, back item and skin. Locked items show which rank they need.
- **Uploads:** your slots as cards showing the cape, a little figure of the skin or the wings (Wear / Wearing), empty slots (choose Cape / Skin / Slim skin / Wings, paste a link, upload) or locked ones (the rank needed).
- **Vote:** one button for each vote site.
- **Live preview:** a 3D model of you wearing everything. Drag to turn it.
Players without the mod on their client get a chest-menu version with the same choices.
---
### πΌοΈ Uploading capes, skins and wings
| Upload | Unlocks at | Image |
| --- | --- | --- |
| **Cape** | Conductor | 64x32 PNG (normal cape file) |
| **Skin** / **Slim skin** | Architect | 64x64 PNG (normal skin file) |
| **Wings** | Industrialist | 64x32 PNG (elytra layout) |
1. Open **Uploads**, pick what you're uploading, paste a direct `https://` link (imgur, Discord or GitHub) and press **Upload**.
2. Confirm. **The slot is permanent:** that upload can't be changed or replaced, so pick carefully.
3. It's worn straight away. Switch between your uploads and the built-in cosmetics any time.
Every upload goes through a small filter first: right size, max 16 KB, the visible part not see-through, and capes and wings not mostly skin-coloured. A refused image doesn't use up the slot. Staff can remove any upload with `/cosmetics remove <player>`, which gives the slot back.
---
### β¨οΈ Commands
| Command | What it does |
| --- | --- |
| `/vote` | Vote links (opens the screen) |
| `/ranks` | Ranks and perks |
| `/cosmetics` | Pick cosmetics |
| `/cosmetics upload cape\|skin\|slim_skin\|wings <link>` | Upload to your next free slot |
| `/fly` | Toggle flight in the Shop (ranks with Shop flight) |
| `/voteranks vote\|add\|set\|info <player>` | Staff: manage votes |
| `/voteranks top [month]` | Staff: top voters |
| `/cosmetics remove\|approve\|banupload <player>` | Staff: manage uploads |
---
### βοΈ Setup (server owners)
1. Install **Create Economy Ranks** and **Modded Votifier** on the server, and add Create Economy Ranks to the modpack.
2. Set Modded Votifier's command to `voteranks vote {player}` and open its port (8192 by default).
3. Add your server on the vote sites and paste the Votifier public key from the server log.
4. Put your vote page links in `config/voteranks/config.json` and run `/voteranks reload`.
**Optional:** Hub Essentials (homes), FTB Chunks (claims), Numismatics (coin rewards), Create Jetpack (Shop flight rules).
Clients without the mod can still join. They see names, tags, trails and the chest menu, but not capes, wings, skins, hats or back items. Once everyone has updated, turn on `requireClientMod` to require it.
---
### π Requirements
- Minecraft **1.21.1**, NeoForge **21.1.200+**
- Server: Modded Votifier, for votes from server lists
- Client: recommended (capes, wings, uploaded skins, hats, back items, the Ranks screen and the cosmetic-mod che

