JoinLeaveLog

JoinLeaveLog posts every join and leave to your game chat and Discord, keeps each player's playtime, and flags first joins and name changes for your staff.

Picture a doorman who never takes a break. A player walks in, I write it down. They leave, I note the time. I keep everybody's hours in a book that survives restarts, and the comings and goings land in your game chat and your Discord. JoinLeaveLog watches the small stuff too: a brand new face gets flagged so you can say hello, and a regular turning up under a new name gets a quiet word to your staff channel.

Supported Features

• The door log: a clean line in game and on Discord every time somebody joins or leaves.
• The playtime book: each player's total hours, written to disk, safe through any restart.
• A flag on new faces: the very first join of a player gets marked, so you can greet them properly.
• Name change alerts: same account, new name. I spot it and tell your staff about it.
• Welcome back: a returning player gets a quiet hello with their total time and how many visits they have made.
• Milestones: a shout when somebody crosses an hour mark you picked, like 10, 50, 100 or 500 hours.
• Who is on right now: one command lists everybody online and how long they have been in this session.
• Their own hours: a player can check their own total time and visit count without bothering you.
• Two webhooks: the odd events, like a name change, can go to a second alert channel your staff watch.
• Runs on its own: Discord and Permissions are both optional, and I work perfectly well without either.
• Your command words: rename any chat command in config.json, or blank one out to switch it off.
• Speaks the language you choose: set it in the config and the lines players read come from a plain text file, so the door log greets people in the language your server actually speaks.

Console & RCON Commands

Player Commands

Players get two. The words are yours to change in config.json, and an empty string switches one off.

Permissions

Permissions is optional. With the plugin missing, or the staff only setting off, /online is open to everybody. The staff gate fails open, so nobody gets shut out of a harmless list 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 put the JoinLeaveLog folder inside ArkApi/Plugins/. Keep the folder name as it is, because it has to carry the same name as the DLL inside it.
2. Open JoinLeaveLog/config.json and set your server name and your options.
3. Want Discord posts? Open discord.json, flip Enabled on and paste your webhook URL.
4. Start the server through AsaApiLoader.exe.
5. Look in ArkApi.log for the line that says the plugin loaded.

Support & Help

Something acting up, or a question before you install? Knock on the Discord door and I will get you sorted: https://discord.gg/8GGaEzWk9p

Frequently Asked Questions

What does JoinLeaveLog do?

JoinLeaveLog keeps a record of everybody coming and going on your server. Joins and leaves go to your game chat and your Discord, each player's total playtime is saved to disk, and first ever joins and name changes get flagged so your staff notice them.

How do I install JoinLeaveLog?

Unzip the download and drop the whole JoinLeaveLog folder into ArkApi/Plugins/, leaving the folder name alone so it matches the DLL. Set your options in config.json, then restart the server through the AsaApi loader and the loaded line lands in ArkApi.log.

Does it work without Discord?

Yes. Discord ships switched off, and JoinLeaveLog still posts the in game lines, keeps the playtime book, and answers both player commands. Turn it on and paste a webhook when you want the same log in a channel.

What sets off the name change alert?

A player joining under a new name on an account I have seen before. With the alert on, the flag goes to your alert webhook, or to the main one if you left the alert blank. Handy for somebody hoping to slip past you quietly.

Will join messages flood my chat?

Not unless you ask for it. Announcing joins and leaves to everybody ships off, so the traffic goes to Discord and your chat stays calm. Flip them on if you would rather the whole server knew.

Can players see each other's playtime?

Only in the loosest sense. A player's own totals are private to them, and the online list shows who is in and how long this session has run. If even that feels like too much, turn on the staff only setting and just your staff can pull the list.

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.