Z-Pulse Owner Guide

How to set up and run Z-Pulse on your Discord. Z-Pulse home · Manager commands

Welcome

Z-Pulse connects your DayZ PlayStation server on Nitrado to your Discord. It gives you an in-game shop, airdrops, factions, bounties, a killfeed, heat maps and admin alerts, all run from Discord and a web dashboard.

Before you start, you need:

• A DayZ PlayStation server rented from Nitrado, on Chernarus, Livonia, Sakhal or Nasdara (Badlands).
• Your Nitrado token. The bot asks for it in a private form, and nobody else sees it.
• A Discord server where you have the Manage Server permission.
• Two Nitrado settings turned on: Log Playerlist and the cfggameplay.json option, both in General settings.
• A restart schedule set in Nitrado. Purchases and airdrops arrive at restarts, so the bot depends on it.

One Discord can run up to 10 game servers. Each one has its own shop, airdrops, factions, stats and bounties.

Getting started

Setup takes about ten minutes and four commands.

1. Invite Z-Pulse to your Discord with the install link.
2. Run /setup. The bot creates its channels and posts the player and manager guides. Running it again later adds any new channels and leaves your existing ones alone.
3. Run /nitrado connect and paste your Nitrado token into the private form. The bot reads your server's map from Nitrado.
4. Run /nitrado delivery on. This lets the shop and airdrops put items on the server. It adds one line to cfggameplay.json and saves your original beside it as cfggameplay.before-shop.json.
5. Run /dashboard to get a private link to the website, where you set up everything else.

Tell your players to run /link with their PSN ID, exactly as it shows in game, capitals included. Purchases, bounties and stats only reach players who have linked.

The channels /setup creates

Faction channels are made automatically when you create factions (see Factions).

Adding more servers

Run /nitrado connect again and pick A new server, then give it a name. Each server gets its own category of channels. With more than one server, commands that act on one server ask which one, and the dashboard has a server picker at the top of each page.

The web dashboard

Run /dashboard in Discord to get a private sign-in link. The link works once and expires after 10 minutes. It signs you in for 12 hours, for that Discord server only.

Every change made on the dashboard or by a manager command is recorded in the private 📋 admin-log channel.

Shop and deliveries

Players buy items with in-game credits, and the items appear next to them at the next server restart. Credits can't be bought with real money.

How players earn credits

Set these on the dashboard's Discord page. Set any of them to 0 to turn it off.

• Starting balance: given once, the first time a player links their PSN ID.
• Daily reward: claimed with /daily, once every 24 hours.
• Pay for time on the server: paid to linked players every 15 minutes, 30 minutes, hour or 2 hours of play.
• Kill reward: paid for each player kill, but not for killing your own faction or the same player twice within half an hour.
• Bounties: see Killfeed and bounties.

With several servers, choose between one wallet for every server or a separate wallet per server.

Setting up the shop

The shop starts empty. On the dashboard's Shop page, pick items from the full DayZ catalogue and give each a price. You can also:

• give an item a shop name that players see instead of the DayZ name
• switch an item off to hide it without losing its price
• set stock to limit how many can be bought between restarts; it refills at every restart
• build bundles: a set of items sold together for one price

You can also use /admin price and /admin remove from Discord.

How delivery works

DayZ on PlayStation can only create items when the server starts. So the bot keeps a spawn file on your server holding every paid purchase, placed at the buyer's last logged position. At the next restart, scheduled or manual, the items appear and the bot marks them delivered.

• Players see what's waiting with /orders, and where it will land with /position.
• You see every waiting purchase with /admin pending, and can cancel one and refund it with /admin refund.
• Positions are logged about every 5 minutes, so a player who just moved may get their items where they stood a few minutes ago.

If you upload your own cfggameplay.json later (to change stamina or loadouts, say), the bot puts its spawn file line back at the next purchase. You can also run /nitrado delivery on again.

Airdrops

An airdrop is a stacked supply crate that lands near a town at one of your scheduled restarts, with smoke rising beside it so players can find it. Airdrops use the same spawn file as the shop, so shop delivery must be on (/nitrado delivery on).

The crates

Every drop is one of the Z-Pulse pre-made crates. Each one is built by hand in the DayZ Editor, so the loot sits properly on the crate. You can't change what's inside a crate, but you choose which crate types can drop: Weapons, Medical, Clothing, Base building and Explosives. Untick a type on the Airdrops page to leave it out.

Crates come in tiers, and the better ones are rarer:

Some crates are made for particular maps; Sakhal and Nasdara, for example, have their own clothing crates. Only the types with a crate for your map are listed, and more crates are added over time.

Settings on the Airdrops page

• How often: off, or every scheduled restart, every 2nd, 3rd or 4th.
• Towns: each map has hand-picked drop spots, named after the nearest town. Untick a town to leave it out, for example one next to your trader. Drops work round the towns so every town gets one before any repeats.
• Drop at next restart: calls in a drop at whatever restart comes next, including a manual one. Pick a crate type with it, or leave it on Any crate type.

What players see

Once the server is back up, the bot posts in the 🪂 airdrops channel: the crate type, the nearest town and a map with an orange search circle. It doesn't give exact coordinates or say what's inside, so players have to go and look. Anything not picked up is gone after the next restart.

Timing: what to know

• Drops are planned 15 minutes before a scheduled restart. The crate and its spot are chosen then and written into the spawn file.
• Manual restarts never bring a drop and don't count toward the next one, unless you used Drop at next restart.
• Avoid manual restarts in the 15 minutes before a scheduled one. A drop already planned would land at your manual restart instead.
• To cancel a drop you called in, turn off Drop at next restart before the restart.
• After a Z-Pulse update, a drop that was already planned keeps the crate it was planned with. The next drop uses the update.

Ask the bot

Players get answers without waiting for an admin. They can use /ask or just @mention the bot with a question.

• Ready-made answers to the common questions, like how to link your PSN ID, how the shop works and how factions work.
• Live server info, pulled in real time: next restart, whether the server is up, your balance, your orders and more.
• Your own answers: add your server's rules, trader location, wipe dates or anything players keep asking.

Adding your own answers

Open the dashboard's Discord page and add a question and its answer. Your answers come first, before the ready-made and live ones, so you can override any of them. Your answers are shared by every game server on your Discord.

A good habit: whenever a player asks you something twice, add it as an answer.

Factions

Factions are player groups you create on the dashboard's Factions page. Each one has a name, an icon, a leader, an optional co-leader, members and a shared bank. There's no member limit, but members must have linked their PSN ID with /link. The co-leader is picked from the members, so add them first. Each faction also has a colour, shown as a circle in front of its channel names; change it with Channel colour.

The channels each faction gets

The bot creates, renames and removes these as you change factions on the dashboard. Turning Private faction chat off deletes the chats and their messages; the public channels stay. Each game server has its own factions.

The faction bank

Any member can put credits in with /faction deposit. Only the leader and co-leader can take them out, with /faction withdraw. Only members and managers can see the balance.

Factions elsewhere in Z-Pulse

• Killing your own faction doesn't pay a kill reward or collect a bounty.
• A zone can belong to a faction as its base. Its members never set it off and are mentioned when someone else does.
• Players can see their faction's stats with /faction stats, and where their teammates are with /faction where.

Killfeed, bounties, heat map and zones

All four are built from your server's admin log, which the bot reads every few minutes.

Killfeed and stats

Every player kill is posted in ⚔️ killfeed with the killer, the weapon and the distance. Other deaths (infected, animals, bleeding, hunger) go to 🪦 pve-feed. On the Discord page you choose whether feeds show locations.

Players check their numbers with /stats and the top 10 with /leaderboard. Leaderboards also post on a timer you set. /admin wipe resets balances or stats; stats wipes keep the killfeed history.

Bounties

Players put credits on someone's head with /bounty place. The first kill by someone outside the target's faction collects every bounty on them, straight into the killer's balance. On the Discord page you set:

• how long a bounty lasts before the credits go back
• the smallest and largest bounty
• whether players can pay off a bounty with /bounty payoff

Managers can post a server-paid bounty with /bountyadmin post, and clear one with a refund using /bountyadmin clear.

Heat map

The 🗺️ heat-map channel gets a picture of where players have been, on the timer you set on the Heat map page. Each post shows only what was logged since the last one. You can keep chosen players off the heat map and kill map, such as your staff.

Choose the map style on the Heat map page: the game map, or satellite. It's set per game server, and it's used for heat maps, kill maps, faction maps and airdrop posts.

Zones

A zone is a circle on the map, such as a base or a safe zone. When the admin log shows a player inside it, the bot posts in the channel you picked. Add one on the Zones page or with /zone add, using the X and Y from iZurvive or /position.

• A base can belong to a faction. Its members never set it off and are mentioned in each ping.
• Add trusted players with /zone allow.
• The same player is pinged again only after the zone's repeat time, 10 minutes unless you change it.
• Positions are logged every few minutes, so a very quick visit can be missed.

Server controls, restarts and admin alerts

Controlling the server

The dashboard's Server page also has the restart schedule, day and night speed, and admin log switches.

Restarts

Purchases and airdrops arrive at restarts, so set a restart schedule in Nitrado. Any interval works.

• Check the time zone in Nitrado matches yours, or restarts will happen at unexpected hours.
• Pick even hours (for example every 2, 3 or 4 hours from midnight) so players can learn the schedule.
• Players can ask the bot when the next restart is with /ask.

Player lists

/ban, /whitelist and /priority manage Nitrado's own lists. The server reads them when it starts, so changes apply from the next restart. The ⛔ ban-list channel shows everyone banned, with the reason, who banned them and when for bans made through Z-Pulse. Its buttons ban a player, lift a ban, or refresh the list after a change made straight in Nitrado.

Admin alerts

The bot watches the admin log and posts suspicious activity in the private 🚨 admin-alerts channel.

Change the time limits on the Discord page. Alerts are a prompt to look into something, not proof: check the killfeed and connections before acting.

Troubleshooting

Start by asking the bot. /ask can check your setup and tell you what's missing, such as the cfggameplay.json option being off.

Getting help

If this guide doesn't answer it, open a ticket in the Z-Pulse Discord or email support@z-pulse.app. The Discord's announcements channel also posts updates and known issues; follow it to see them in your own Discord. Include:

• your Discord server's name and which game server it's about
• what you did and what you expected
• what happened instead, with a screenshot if you can
• roughly when it happened, with your time zone

Never send your Nitrado token or any password to anyone, including Z-Pulse support. We never need them.

We aim to reply within 24 hours. Replies may take longer during holidays or unexpected absences; when that happens, we'll post a notice and get back to you as soon as we can.