Polls

Polls lets you ask your whole server a question in chat and count every vote, with an auto end timer, plain result bars and Discord posts built right in.

Polls puts a quick show of hands in your server chat. Post a question with up to nine choices, let every player answer with a single number, and get a counted result the moment the clock runs out. Running counts stay hidden unless you say otherwise, so the first few votes do not drag everybody else along. The open poll and its votes are saved, so a restart in the middle of a vote costs you nothing.

Supported Features

• One line to start: staff type the question and the choices separated by pipes, and the poll goes out to everybody at once.
• Vote with one number: a player types the vote command and a digit. One vote each, and a later vote quietly replaces the earlier one.
• Counts hidden by default: players can see how many have voted but not for what, so the early birds do not sway the rest. Turn it on if you would rather show live bars.
• It closes itself: a poll ends on its own after the minutes you set, with a warning shout before it shuts. Set the timer to zero and it waits for staff instead.
• Result bars anybody can read: results come out as plain bars like [####------] 40% (4) with the winner called out, which reads fine in game and on Discord.
• Nine choices at most: the cap keeps every choice on a single digit, so voting never gets fiddly.
• A history to look back on: finished polls are kept on file and any player can pull up the last one.
• Let players pay to ask: set a start cost above zero and any player may start a poll by paying ArkShop points. Leave it at zero and starting stays staff only.
• A staff gate: starting and ending a poll is locked to a Permissions node, and the trusted server console can always close one.
• Discord posts: switch on the webhook and I post the question when a poll opens and the full result when it ends.
• Survives a restart: the open poll, every vote and the history are saved. A poll whose time ran out while the server was down closes on the next tick.
• Ask in your language: set it in the config and my own lines come from a plain text file you can edit, so the voting reads naturally for the people on your server.

Console & RCON Commands

Player Commands

Both chat words are read from config.json, so you can rename them there or switch them off.

Permissions

The staff gate is fail closed on purpose. With Permissions missing or switched off no player passes the check, so you start and end polls from the console or over RCON, or set a start cost and let players pay for the privilege.

Config

To see every configuration option, visit our docs. To edit your config files the easy way, open our configuration editor.

Requirements

• AsaApi v2.01 or newer
• A Windows server running ArkAscendedServer through the AsaApi loader
• Permissions (optional, works without it, and staff commands then run from the console)
• ArkShop or WShop (optional, only needed when players pay to start a poll)
• A Discord webhook (optional, works without it)

Installation

1. Unzip the download.
2. Put the Polls folder into ArkApi/Plugins/. Keep the folder name as it is, since AsaApi only loads a plugin whose folder carries the same name as its DLL.
3. Open Polls/config.json and set your command words and your timer, then drop your webhook into discord.json beside it if you want the posts.
4. Restart the server through AsaApiLoader.exe.
5. Watch ArkApi.log for the loaded line, then start a poll and see who is paying attention.

Support & Help

Stuck on a step, or did something break? Ask in the Discord and I will sort it out with you: https://discord.gg/8GGaEzWk9p

Frequently Asked Questions

What does Polls do?

Polls lets you ask your server a question and counts the answers. Staff start a poll in one line, players vote with a single number, and the result goes up in chat and on Discord with the winner called out.

How do I install Polls?

Unzip the download and place the Polls folder in ArkApi/Plugins/, leaving the folder name alone because AsaApi matches it against the DLL inside. Set your options in config.json and restart the server through the AsaApi loader.

Can two polls run at once?

No, one at a time. A second start is turned down while a poll is running, which keeps voting simple for everybody. Close the open one from chat or the console and then start the next.

Can players start their own polls?

Yes, if you let them. By default only staff holding the manage node may start one. Put a start cost above zero and any player can start a poll by paying that many ArkShop points, charged up front so the poll only opens if they can afford it.

Can I hide the vote counts while a poll is open?

Yes, and I hide them by default. Players see how many have voted but not what for, so the early votes do not drag the rest along. Turn it on if you would rather everybody watched the bars move.

What happens to a poll when the server restarts?

Nothing is lost. The open poll, every vote and the history go to disk, so a restart brings them all back. If the end time passed while the server was down, the poll closes and posts its result on the first tick after boot.

Was any AI content used in the making of this?

The source code itself was fully created by myself. I do use ChatGPT occasionally to generate product images, and I do use ChatGPT to generate the website descriptions. I do this because I don't speak native English perfectly. I am natively from Sweden, so I use GPT to help translate and write product descriptions. I also will sometimes use GPT to write better English logs. Majority of my Free plugins are open source, so you can review the code yourself and freely fork and edit it to your liking.