JoinLeaveLog

JoinLeaveLog posts every join and leave to your game chat and Discord, tracks playtime, and flags first joins and name changes so you never miss a thing.

I built JoinLeaveLog so you always know who comes and goes on your ARK server. It posts a clean line for every join and leave, in game and on Discord, and keeps a running playtime count for each player. It flags a first ever join and a name change on the same account, so a player can not sneak in quiet. It runs on its own with JSON storage, and Discord and Permissions are both optional.

Supported Features

• Join and leave lines: I post a clean line every time a player joins or leaves, in game and on Discord.
• Playtime tracking: I keep a running total of hours for each player, saved to disk so a restart never loses it.
• First join flag: I mark the first ever join of a new player so you can greet them right.
• Name change alert: I catch a player who joins under a new name on the same account and flag it for you.
• Welcome back message: I send returning players a private hello with their total time and visit count.
• Playtime milestones: I shout out when a player crosses a set hour mark, like 10, 50, 100, or 500 hours.
• Online list: /online shows who is on right now and for how long.
• Personal playtime: /played shows a player their own total time and visit count.
• Two Discord webhooks: I can route odd events like a name change to a second alert webhook.
• Works without Discord or Permissions: both pillars are optional and the plugin still runs fine without them.
• Config driven commands: rename any chat command or turn it off in config.json.

Console & RCON Commands

Player Commands

Command names live in config.json, so you can rename them or turn one off.

Permissions

Permissions is optional. When the Permissions plugin is not installed, or StaffOnlyOnline is off, the /online command is open to everyone. The staff gate fails open, so nobody gets locked out by accident.

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, only needed for the staff gate on /online)
• A Discord webhook (optional, works without it)

Installation

1. Unzip the download and drop the JoinLeaveLog folder into ArkApi/Plugins/ so the folder name matches the DLL.
2. Open JoinLeaveLog/config.json and set your server name and options.
3. To use Discord, set Discord.Enabled to true and paste your webhook URL.
4. Restart the server with AsaApiLoader.exe.
5. Watch ArkApi.log for the line that says the plugin loaded.

Support & Help

Need a hand or hit a snag? Join the Discord and I will help you get it running: https://discord.gg/8GGaEzWk9p

Frequently Asked Questions

What does JoinLeaveLog do? JoinLeaveLog posts a clean line every time a player joins or leaves your ARK server, both in game and on Discord. It also tracks each player's total playtime, flags first ever joins, and alerts you when a player joins under a new name on the same account. You get a simple record of who comes and goes.

Does JoinLeaveLog work without Discord? Yes. JoinLeaveLog works fine with Discord turned off. The in game join and leave messages, playtime tracking, and the /online and /played commands all still run. When you are ready, just set Discord.Enabled to true and paste a webhook URL to add Discord posts.

How do I install JoinLeaveLog? Unzip the download and put the JoinLeaveLog folder into your server's ArkApi/Plugins/ folder so the folder name matches the DLL. Edit config.json to set your options, then restart the server with the AsaApi loader. Check ArkApi.log for the loaded line and you are done.

Does JoinLeaveLog need the Permissions plugin? No. JoinLeaveLog runs without Permissions. You only need it if you want to gate the /online command to staff with the JoinLeaveLog.Staff node. Without Permissions, or with the staff gate off, /online is open to everyone.

Can JoinLeaveLog track playtime? Yes. JoinLeaveLog keeps a running total of hours for each player and saves it to disk, so a restart never loses it. Players check their own time with /played, and you can set hour milestones that trigger a server and Discord shout when a player crosses them.

JoinLeaveLog v0.0.1