Merge pull request #466 from Hornwitser/player-tracking

Per player statistics
This commit is contained in:
Hornwitser authored and GitHub committed 2022-07-13 22:49:33 +02:00
commit d184b9db81
25 files changed
+908 -111

No files matched your search

+1 -4
View File
@@ -6,10 +6,7 @@ module.exports = {
"env": { "env": {
"node": true, "node": true,
"commonjs": true, "commonjs": true,
"es6": true, "es2022": true,
},
"parserOptions": {
"ecmaVersion": 11,
}, },
"overrides": [ "overrides": [
+10
View File
@@ -50,6 +50,16 @@ Terminates the running Factorio server without giving it a chance to save or cle
Note: This may cause loss of data. Note: This may cause loss of data.
### Extract players from instance
ctl> instance extract-players <name>
Creates a user account in the cluster for each player that has been online on the currently running save of the instance and sets the play time of that account on this instance to the online time recorded in the save.
Useful when importing a save to a cluster.
Note that the online time in a save is recorded differntly from how Clusterio records online time.
Most notably Clusterio records wall clock time while the save time is recorded in ticks and this extraction of player time assumes the game runs at 60 ticks a second.
### Config management ### Config management
+1 -1
View File
@@ -25,7 +25,7 @@
"@clusterio/lib": "workspace:*", "@clusterio/lib": "workspace:*",
"@clusterio/master": "workspace:*", "@clusterio/master": "workspace:*",
"@clusterio/slave": "workspace:*", "@clusterio/slave": "workspace:*",
"eslint": "^7.25.0", "eslint": "^8.18.0",
"eslint-plugin-node": "^11.1.0", "eslint-plugin-node": "^11.1.0",
"express": "^4.16.2", "express": "^4.16.2",
"form-data": "^4.0.0", "form-data": "^4.0.0",
+2
View File
@@ -89,6 +89,8 @@ class Control extends libLink.Link {
async saveListUpdateEventHandler() { } async saveListUpdateEventHandler() { }
async userUpdateEventHandler() { }
async setLogSubscriptions({ async setLogSubscriptions({
all = false, all = false,
master = false, master = false,
+64 -1
View File
@@ -748,6 +748,19 @@ instanceCommands.add(new libCommand.Command({
}, },
})); }));
instanceCommands.add(new libCommand.Command({
definition: ["extract-players <instance>", "Extract players from running save into the cluster.", (yargs) => {
yargs.positional("instance", { describe: "Instance to extract players and play time from", type: "string" });
}],
handler: async function(args, control) {
let instanceId = await libCommand.resolveInstance(control, args.instance);
await control.setLogSubscriptions({ instance_ids: [instanceId] });
await libLink.messages.extractPlayers.send(control, {
instance_id: instanceId,
});
},
}));
instanceCommands.add(new libCommand.Command({ instanceCommands.add(new libCommand.Command({
definition: ["start <instance>", "Start instance", (yargs) => { definition: ["start <instance>", "Start instance", (yargs) => {
yargs.positional("instance", { describe: "Instance to start", type: "string" }); yargs.positional("instance", { describe: "Instance to start", type: "string" });
@@ -941,9 +954,59 @@ roleCommands.add(new libCommand.Command({
const userCommands = new libCommand.CommandTree({ name: "user", alias: ["u"], description: "User management" }); const userCommands = new libCommand.CommandTree({ name: "user", alias: ["u"], description: "User management" });
userCommands.add(new libCommand.Command({ userCommands.add(new libCommand.Command({
definition: [["list", "l"], "List user in the cluster"], definition: ["show <name>", "Show details for one user", (yargs) => {
yargs.positional("name", { decribe: "Name of user to show", type: "string" });
yargs.options({
"instance-stats": { describe: "include per-instance stats", nargs: 0, type: "boolean", default: false },
});
}],
handler: async function(args, control) {
let response = await libLink.messages.getUser.send(control, { name: args.name });
delete response["seq"];
Object.assign(response, response["player_stats"]);
delete response["player_stats"];
let instanceStats = response["instance_stats"];
delete response["instance_stats"];
print(asTable(Object.entries(response).map(([property, value]) => ({ property, value }))));
if (args.instanceStats) {
let instances = (await libLink.messages.listInstances.send(control)).list;
function instanceName(id) {
let instance = instances.find(i => i.id === id);
if (instance) {
return instance.name;
}
return "<deleted>";
}
for (let [id, playerInstanceStats] of instanceStats) {
print();
print(`Instance ${instanceName(id)} (${id}):`);
print(asTable(Object.entries(playerInstanceStats).map(([property, value]) => ({ property, value }))));
}
}
},
}));
userCommands.add(new libCommand.Command({
definition: [["list", "l"], "List user in the cluster", (yargs) => {
yargs.options({
"stats": { describe: "include user stats", nargs: 0, type: "boolean", default: false },
"attributes": { describe: "include admin/whitelisted/banned", nargs: 0, type: "boolean", default: false },
});
}],
handler: async function(args, control) { handler: async function(args, control) {
let response = await libLink.messages.listUsers.send(control); let response = await libLink.messages.listUsers.send(control);
for (let user of response.list) {
if (args.stats) {
Object.assign(user, user["player_stats"]);
}
delete user["player_stats"];
if (!args.attributes) {
delete user["is_admin"];
delete user["is_whitelisted"];
delete user["is_banned"];
}
}
print(asTable(response.list)); print(asTable(response.list));
}, },
})); }));
+84
View File
@@ -0,0 +1,84 @@
"use strict";
/**
* Stastics collected about a player.
* @alias module:lib/PlayerStats
*/
class PlayerStats {
/**
* Count of the number of times this player has been seen joining this server.
* @type {number}
*/
joinCount = 0;
/**
* Time in ms this player has been seen online on this instance.
* @type {number}
*/
onlineTimeMs = 0;
/**
* Timestamp the player was last seen joining.
* @type {Date=}
*/
lastJoinAt;
/**
* Timestamp the player was last seen leaving.
* @type {Date=}
*/
lastLeaveAt;
/**
* Reason the player was last seen leaving with.
* @type {string=}
*/
lastLeaveReason;
static jsonSchema = {
type: "object",
properties: {
"join_count": { type: "integer" },
"online_time_ms": { type: "number" },
"last_join_at": { type: "number" },
"last_leave_at": { type: "number" },
"last_leave_reason": { type: "string" },
},
};
constructor(json = {}) {
if (json["join_count"]) {
this.joinCount = json["join_count"];
}
if (json["online_time_ms"]) {
this.onlineTimeMs = json["online_time_ms"];
}
if (json["last_join_at"]) {
this.lastJoinAt = new Date(json["last_join_at"]);
}
if (json["last_leave_at"]) {
this.lastLeaveAt = new Date(json["last_leave_at"]);
this.lastLeaveReason = json["last_leave_reason"] || "quit";
}
}
toJSON() {
let json = {};
if (this.joinCount) {
json["join_count"] = this.joinCount;
}
if (this.onlineTimeMs) {
json["online_time_ms"] = this.onlineTimeMs;
}
if (this.lastJoinAt) {
json["last_join_at"] = this.lastJoinAt.getTime();
}
if (this.lastLeaveAt) {
json["last_leave_at"] = this.lastLeaveAt.getTime();
json["last_leave_reason"] = this.lastLeaveReason;
}
return json;
}
}
module.exports = PlayerStats;
+64 -10
View File
@@ -3,6 +3,7 @@
const libSchema = require("../schema"); const libSchema = require("../schema");
const libErrors = require("../errors"); const libErrors = require("../errors");
const { logger } = require("../logging"); const { logger } = require("../logging");
const PlayerStats = require("../PlayerStats");
class MissingLinkHandlerError extends Error { class MissingLinkHandlerError extends Error {
constructor(type, source, target) { constructor(type, source, target) {
@@ -667,6 +668,13 @@ messages.exportData = new Request({
forwardTo: "instance", forwardTo: "instance",
}); });
messages.extractPlayers = new Request({
type: "extract_players",
links: ["control-master", "master-slave", "slave-instance"],
permission: "core.instance.extract_players",
forwardTo: "instance",
});
messages.stopInstance = new Request({ messages.stopInstance = new Request({
type: "stop_instance", type: "stop_instance",
links: ["control-master", "master-slave", "slave-instance"], links: ["control-master", "master-slave", "slave-instance"],
@@ -786,6 +794,36 @@ messages.deleteRole = new Request({
}, },
}); });
const userRequired = ["name", "roles", "instances"];
const userProperties = {
"name": { type: "string" },
"roles": { type: "array", items: { type: "integer" }},
"is_admin": { type: "boolean" },
"is_banned": { type: "boolean" },
"is_whitelisted": { type: "boolean" },
"instances": { type: "array", items: { type: "integer" }},
"is_deleted": { type: "boolean" },
"player_stats": PlayerStats.jsonSchema,
"instance_stats": {
type: "array",
items: {
type: "array",
items: [{ type: "integer" }, PlayerStats.jsonSchema],
},
},
};
messages.getUser = new Request({
type: "get_user",
links: ["control-master"],
permission: "core.user.get",
requestProperties: {
"name": { type: "string" },
},
responseRequired: userRequired,
responseProperties: userProperties,
});
messages.listUsers = new Request({ messages.listUsers = new Request({
type: "list_users", type: "list_users",
links: ["control-master"], links: ["control-master"],
@@ -795,20 +833,26 @@ messages.listUsers = new Request({
type: "array", type: "array",
items: { items: {
additionalProperties: false, additionalProperties: false,
required: ["name", "roles", "instances"], required: userRequired,
properties: { properties: userProperties,
"name": { type: "string" },
"roles": { type: "array", items: { type: "integer" }},
"is_admin": { type: "boolean" },
"is_banned": { type: "boolean" },
"is_whitelisted": { type: "boolean" },
"instances": { type: "array", items: { type: "integer" }},
},
}, },
}, },
}, },
}); });
messages.setUserSubscriptions = new Request({
type: "set_user_subscriptions",
links: ["control-master"],
permission: "core.user.subscribe",
requestProperties: {
"all": { type: "boolean" },
"names": {
type: "array",
items: { type: "string" },
},
},
});
messages.createUser = new Request({ messages.createUser = new Request({
type: "create_user", type: "create_user",
links: ["control-master"], links: ["control-master"],
@@ -1218,6 +1262,13 @@ messages.saveListUpdate = new Event({
}, },
}); });
messages.userUpdate = new Event({
type: "user_update",
links: ["master-control"],
eventRequired: userRequired,
eventProperties: userProperties,
});
messages.masterConnectionEvent = new Event({ messages.masterConnectionEvent = new Event({
type: "master_connection_event", type: "master_connection_event",
links: ["slave-instance"], links: ["slave-instance"],
@@ -1284,10 +1335,13 @@ messages.playerEvent = new Event({
type: "player_event", type: "player_event",
links: ["instance-slave", "slave-master"], links: ["instance-slave", "slave-master"],
forwardTo: "master", forwardTo: "master",
eventRequired: ["instance_id", "type", "name"],
eventProperties: { eventProperties: {
"instance_id": { type: "integer" }, "instance_id": { type: "integer" },
"type": { type: "string", enum: ["join", "leave"] }, "type": { type: "string", enum: ["join", "leave", "import"] },
"name": { type: "string" }, "name": { type: "string" },
"reason": { type: "string" },
"stats": PlayerStats.jsonSchema,
}, },
}); });
+10 -2
View File
@@ -206,8 +206,12 @@ class BaseInstancePlugin {
* Invoked when a player either joins or leaves the instance. * Invoked when a player either joins or leaves the instance.
* *
* @param {Object} event - Information about the event. * @param {Object} event - Information about the event.
* @param {string} event.type - Either "join" or "leave". * @param {string} event.type - Either "join", "leave" or "import".
* @param {string} event.name - Name of the player that joined/left. * @param {string} event.name - Name of the player that joined/left.
* @param {string=} event.reason -
* Only present for type "leave". Reason for player leaving the
* game, one of the possible reasons in defines.disconnect_reason
* or "server_quit" if the server exits while the player is online.
*/ */
async onPlayerEvent(event) { } async onPlayerEvent(event) { }
@@ -498,8 +502,12 @@ class BaseMasterPlugin {
* *
* @param {Object} instance - the instance it occured on. * @param {Object} instance - the instance it occured on.
* @param {Object} event - Information about the event. * @param {Object} event - Information about the event.
* @param {string} event.type - Either "join" or "leave". * @param {string} event.type - Either "join", "leave" or "import".
* @param {string} event.name - Name of the player that joined/left. * @param {string} event.name - Name of the player that joined/left.
* @param {string=} event.reason -
* Only present for type "leave". Reason for player leaving the
* game, one of the possible reasons in defines.disconnect_reason
* or "server_quit" if the server exits while the player is online.
*/ */
async onPlayerEvent(instance, event) { } async onPlayerEvent(instance, event) { }
+63
View File
@@ -11,6 +11,8 @@ const jwt = require("jsonwebtoken");
const libErrors = require("./errors"); const libErrors = require("./errors");
const PlayerStats = require("./PlayerStats");
/** /**
* Represents a permission that can be granted * Represents a permission that can be granted
@@ -195,6 +197,28 @@ class User {
} }
} }
} }
/**
* Per instance statistics for the player this user account is tied to.
* @type {Map<number, module:lib/PlayerStats>}
*/
this.instanceStats = new Map(
(serializedUser.instance_stats ? serializedUser.instance_stats : []).map(
([id, stats]) => [id, new PlayerStats(stats)]
)
);
/**
* Combined statistics for the player this user account is tied to.
* @type {module:lib/PlayerStats}
*/
this.playerStats = this._calculatePlayerStats();
/**
* True if this user object has been removed from the cluster.
* @type {boolean}
*/
this.isDeleted = false;
} }
serialize() { serialize() {
@@ -226,6 +250,10 @@ class User {
serialized.ban_reason = this.banReason; serialized.ban_reason = this.banReason;
} }
if (this.instanceStats.size) {
serialized.instance_stats = [...this.instanceStats].map(([id, stats]) => [id, stats.toJSON()]);
}
return serialized; return serialized;
} }
@@ -285,6 +313,26 @@ class User {
User.onlineUsers.delete(this); User.onlineUsers.delete(this);
} }
} }
recalculatePlayerStats() {
this.playerStats = this._calculatePlayerStats();
}
_calculatePlayerStats() {
let playerStats = new PlayerStats();
for (let instanceStats of this.instanceStats.values()) {
if (!playerStats.lastJoinAt || instanceStats.lastJoinAt > playerStats.lastJoinAt) {
playerStats.lastJoinAt = instanceStats.lastJoinAt;
}
if (!playerStats.lastLeaveAt || instanceStats.lastLeaveAt > playerStats.lastLeaveAt) {
playerStats.lastLeaveAt = instanceStats.lastLeaveAt;
playerStats.lastLeaveReason = instanceStats.lastLeaveReason;
}
playerStats.joinCount += instanceStats.joinCount;
playerStats.onlineTimeMs += instanceStats.onlineTimeMs;
}
return playerStats;
}
} }
/** /**
* Set of users currently online in the cluster. * Set of users currently online in the cluster.
@@ -427,6 +475,11 @@ definePermission({
title: "Export locale and icons", title: "Export locale and icons",
description: "Export the the locale and icons from an instance and upload it to the master.", description: "Export the the locale and icons from an instance and upload it to the master.",
}); });
definePermission({
name: "core.instance.extract_players",
title: "Extract player stats from running save",
description: "Run extraction to create a user for each player in the save and set the play time from the save.",
});
definePermission({ definePermission({
name: "core.instance.start", name: "core.instance.start",
title: "Start instance", title: "Start instance",
@@ -487,11 +540,21 @@ definePermission({
description: "Permanently delete roles.", description: "Permanently delete roles.",
}); });
definePermission({
name: "core.user.get",
title: "Get user",
description: "Get the details of a user in the cluster.",
});
definePermission({ definePermission({
name: "core.user.list", name: "core.user.list",
title: "List users", title: "List users",
description: "Get the full list of users in the cluster.", description: "Get the full list of users in the cluster.",
}); });
definePermission({
name: "core.user.subscribe",
title: "Subscribe to user updates",
description: "Subscribe to be notified on updates on the details and status of users.",
});
definePermission({ definePermission({
name: "core.user.create", name: "core.user.create",
title: "Create users", title: "Create users",
+58 -2
View File
@@ -53,6 +53,11 @@ class ControlConnection extends BaseConnection {
instance_ids: [], instance_ids: [],
}; };
this.userSubscriptions = {
all: false,
names: [],
};
this.logTransport = null; this.logTransport = null;
this.logSubscriptions = { this.logSubscriptions = {
all: false, all: false,
@@ -559,6 +564,25 @@ class ControlConnection extends BaseConnection {
} }
} }
async getUserRequestHandler(message) {
let name = message.data.name;
let user = this._master.userManager.users.get(name);
if (!user) {
throw new libErrors.RequestError(`User ${name} does not exist`);
}
return {
name: user.name,
roles: [...user.roles].map(role => role.id),
is_admin: user.isAdmin,
is_banned: user.isBanned,
is_whitelisted: user.isWhitelisted,
instances: [...user.instances],
player_stats: user.playerStats,
instance_stats: [...user.instanceStats],
};
}
async listUsersRequestHandler(message) { async listUsersRequestHandler(message) {
let list = []; let list = [];
for (let user of this._master.userManager.users.values()) { for (let user of this._master.userManager.users.values()) {
@@ -569,13 +593,38 @@ class ControlConnection extends BaseConnection {
is_banned: user.isBanned, is_banned: user.isBanned,
is_whitelisted: user.isWhitelisted, is_whitelisted: user.isWhitelisted,
instances: [...user.instances], instances: [...user.instances],
player_stats: user.playerStats,
}); });
} }
return { list }; return { list };
} }
async setUserSubscriptionsRequestHandler(message) {
this.userSubscriptions = message.data;
}
userUpdated(user) {
if (
this.userSubscriptions.all
|| this.userSubscriptions.names.includes(user.name)
) {
libLink.messages.userUpdate.send(this, {
name: user.name,
roles: [...user.roles].map(role => role.id),
is_admin: user.isAdmin,
is_banned: user.isBanned,
is_whitelisted: user.isWhitelisted,
instances: [...user.instances],
player_stats: user.playerStats,
instance_stats: [...user.instanceStats],
is_deleted: user.isDeleted,
});
}
}
async createUserRequestHandler(message) { async createUserRequestHandler(message) {
this._master.userManager.createUser(message.data.name); let user = this._master.userManager.createUser(message.data.name);
this._master.userUpdated(user);
} }
async updateUserRolesRequestHandler(message) { async updateUserRolesRequestHandler(message) {
@@ -596,6 +645,7 @@ class ControlConnection extends BaseConnection {
user.roles = resolvedRoles; user.roles = resolvedRoles;
this._master.userPermissionsUpdated(user); this._master.userPermissionsUpdated(user);
this._master.userUpdated(user);
} }
async setUserAdminRequestHandler(message) { async setUserAdminRequestHandler(message) {
@@ -611,6 +661,7 @@ class ControlConnection extends BaseConnection {
} }
user.isAdmin = admin; user.isAdmin = admin;
this._master.userUpdated(user);
this.broadcastEventToSlaves({ data: { name, admin }}, libLink.messages.adminlistUpdate); this.broadcastEventToSlaves({ data: { name, admin }}, libLink.messages.adminlistUpdate);
} }
@@ -628,6 +679,7 @@ class ControlConnection extends BaseConnection {
user.isBanned = banned; user.isBanned = banned;
user.banReason = reason; user.banReason = reason;
this._master.userUpdated(user);
this.broadcastEventToSlaves({ data: { name, banned, reason }}, libLink.messages.banlistUpdate); this.broadcastEventToSlaves({ data: { name, banned, reason }}, libLink.messages.banlistUpdate);
} }
@@ -644,6 +696,7 @@ class ControlConnection extends BaseConnection {
} }
user.isWhitelisted = whitelisted; user.isWhitelisted = whitelisted;
this._master.userUpdated(user);
this.broadcastEventToSlaves({ data: { name, whitelisted }}, libLink.messages.whitelistUpdate); this.broadcastEventToSlaves({ data: { name, whitelisted }}, libLink.messages.whitelistUpdate);
} }
@@ -653,6 +706,10 @@ class ControlConnection extends BaseConnection {
throw new libErrors.RequestError(`User '${message.data.name}' does not exist`); throw new libErrors.RequestError(`User '${message.data.name}' does not exist`);
} }
user.isDeleted = true;
this._master.userManager.users.delete(message.data.name);
this._master.userUpdated(user);
if (user.is_admin) { if (user.is_admin) {
this.broadcastEventToSlaves({ data: { name, admin: false }}, libLink.messages.adminlistUpdate); this.broadcastEventToSlaves({ data: { name, admin: false }}, libLink.messages.adminlistUpdate);
} }
@@ -662,7 +719,6 @@ class ControlConnection extends BaseConnection {
if (user.is_banned) { if (user.is_banned) {
this.broadcastEventToSlaves({ data: { name, banned: false, reason: "" }}, libLink.messages.banlistUpdate); this.broadcastEventToSlaves({ data: { name, banned: false, reason: "" }}, libLink.messages.banlistUpdate);
} }
this._master.userManager.users.delete(message.data.name);
} }
async debugDumpWsRequestHandler(message) { async debugDumpWsRequestHandler(message) {
+10
View File
@@ -503,6 +503,16 @@ class Master {
} }
} }
userUpdated(user) {
for (let controlConnection of this.wsServer.controlConnections) {
if (controlConnection.connector.closing) {
continue;
}
controlConnection.userUpdated(user);
}
}
/** /**
* Notify connected control clients under the given user that the * Notify connected control clients under the given user that the
* permissions for this user may have changed. * permissions for this user may have changed.
+6 -1
View File
@@ -3,6 +3,7 @@ const libConfig = require("@clusterio/lib/config");
const libLink = require("@clusterio/lib/link"); const libLink = require("@clusterio/lib/link");
const { logger } = require("@clusterio/lib/logging"); const { logger } = require("@clusterio/lib/logging");
const libPlugin = require("@clusterio/lib/plugin"); const libPlugin = require("@clusterio/lib/plugin");
const PlayerStats = require("@clusterio/lib/PlayerStats");
const BaseConnection = require("./BaseConnection"); const BaseConnection = require("./BaseConnection");
@@ -175,7 +176,7 @@ class SlaveConnection extends BaseConnection {
} }
async playerEventEventHandler(message) { async playerEventEventHandler(message) {
let { instance_id, name, type } = message.data; let { instance_id, name, type, stats } = message.data;
let user = this._master.userManager.users.get(name); let user = this._master.userManager.users.get(name);
if (!user) { if (!user) {
user = this._master.userManager.createUser(name); user = this._master.userManager.createUser(name);
@@ -186,7 +187,11 @@ class SlaveConnection extends BaseConnection {
} else if (type === "leave") { } else if (type === "leave") {
user.notifyLeave(instance_id); user.notifyLeave(instance_id);
} }
user.instanceStats.set(instance_id, new PlayerStats(stats));
user.recalculatePlayerStats();
this._master.userUpdated(user);
delete message.data.stats;
let instance = this._master.instances.get(instance_id); let instance = this._master.instances.get(instance_id);
await libPlugin.invokeHook(this._master.plugins, "onPlayerEvent", instance, message.data); await libPlugin.invokeHook(this._master.plugins, "onPlayerEvent", instance, message.data);
} }
+10 -1
View File
@@ -28,9 +28,18 @@ impl.events[defines.events.on_player_joined_game] = function(event)
api.send_json("player_event", { type = "join", name = player.name }) api.send_json("player_event", { type = "join", name = player.name })
end end
local disconnect_reason_name = {}
for name, i in pairs(defines.disconnect_reason) do
disconnect_reason_name[i] = name
end
impl.events[defines.events.on_player_left_game] = function(event) impl.events[defines.events.on_player_left_game] = function(event)
local player = game.players[event.player_index] local player = game.players[event.player_index]
api.send_json("player_event", { type = "leave", name = player.name }) api.send_json("player_event", {
type = "leave",
name = player.name,
reason = disconnect_reason_name[event.reason],
})
end end
-- Internal API -- Internal API
+54 -30
View File
@@ -9,6 +9,7 @@ const util = require("util");
const libFileOps = require("@clusterio/lib/file_ops"); const libFileOps = require("@clusterio/lib/file_ops");
const libFactorio = require("@clusterio/lib/factorio"); const libFactorio = require("@clusterio/lib/factorio");
const libLink = require("@clusterio/lib/link"); const libLink = require("@clusterio/lib/link");
const PlayerStats = require("@clusterio/lib/PlayerStats");
const libPlugin = require("@clusterio/lib/plugin"); const libPlugin = require("@clusterio/lib/plugin");
const libPluginLoader = require("@clusterio/lib/plugin_loader"); const libPluginLoader = require("@clusterio/lib/plugin_loader");
const libErrors = require("@clusterio/lib/errors"); const libErrors = require("@clusterio/lib/errors");
@@ -250,30 +251,13 @@ class Instance extends libLink.Link {
if (event.type === "join") { if (event.type === "join") {
this._recordPlayerJoin(event.name); this._recordPlayerJoin(event.name);
} else if (event.type === "leave") { } else if (event.type === "leave") {
this._recordPlayerLeave(event.name); this._recordPlayerLeave(event.name, event.reason);
} }
}); });
/**
* @typedef module:slave/src/Instance~PlayerStat
* @type {object}
* @property {number} lastJoinAt -
* Unix timestamp in ms the player was last seen joining this
* instance.
* @property {number=} lastLeaveAt -
* Unix timestamp in ms the player was last seen leaving this
* instance. Not present if player has yet to leave after first
* time joining.
* @property {number} joinCount -
* Count of the number of times this player has been seen
* joining this server.
* @property {number} onlineTimeMs -
* Time in ms this player has been seen online on this instance.
*/
/** /**
* Per player statistics recorded by this instance. * Per player statistics recorded by this instance.
* @type {Map<string, module:slave/src/Instance~PlayerStat>} * @type {Map<string, module:lib/PlayerStats>}
*/ */
this.playerStats = new Map(); this.playerStats = new Map();
@@ -297,7 +281,12 @@ class Instance extends libLink.Link {
if (parsed.action === "JOIN") { if (parsed.action === "JOIN") {
this._recordPlayerJoin(name); this._recordPlayerJoin(name);
} else if (["LEAVE", "KICK", "BAN"].includes(parsed.action)) { } else if (["LEAVE", "KICK", "BAN"].includes(parsed.action)) {
this._recordPlayerLeave(name); let reason = {
"LEAVE": "quit",
"KICK": "kicked",
"BAN": "banned",
}[parsed.action];
this._recordPlayerLeave(name, reason);
} }
}); });
@@ -322,7 +311,7 @@ class Instance extends libLink.Link {
this.playersOnline.forEach(player => joined.delete(player)); this.playersOnline.forEach(player => joined.delete(player));
for (let player of left) { for (let player of left) {
this._recordPlayerLeave(player); this._recordPlayerLeave(player, "quit");
} }
// Missing join messages is not supposed to happen. // Missing join messages is not supposed to happen.
@@ -343,40 +332,72 @@ class Instance extends libLink.Link {
let stats = this.playerStats.get(name); let stats = this.playerStats.get(name);
if (!stats) { if (!stats) {
stats = { joinCount: 0, onlineTimeMs: 0 }; stats = new PlayerStats();
this.playerStats.set(name, stats); this.playerStats.set(name, stats);
} }
stats.lastJoinAt = Date.now(); stats.lastJoinAt = new Date();
stats.joinCount += 1; stats.joinCount += 1;
let event = { let event = {
instance_id: this.id, instance_id: this.id,
type: "join", type: "join",
name, name,
stats: stats.toJSON(),
}; };
libLink.messages.playerEvent.send(this, event); libLink.messages.playerEvent.send(this, event);
libPlugin.invokeHook(this.plugins, "onPlayerEvent", event); libPlugin.invokeHook(this.plugins, "onPlayerEvent", event);
} }
_recordPlayerLeave(name) { _recordPlayerLeave(name, reason) {
if (!this.playersOnline.delete(name)) { if (!this.playersOnline.delete(name)) {
return; return;
} }
let stats = this.playerStats.get(name); let stats = this.playerStats.get(name);
stats.lastLeaveAt = Date.now(); stats.lastLeaveAt = new Date();
stats.onlineTimeMs += stats.lastLeaveAt - stats.lastJoinAt; stats.lastLeaveReason = reason;
stats.onlineTimeMs += stats.lastLeaveAt.getTime() - stats.lastJoinAt.getTime();
this._hadPlayersOnline = true; this._hadPlayersOnline = true;
let event = { let event = {
instance_id: this.id, instance_id: this.id,
type: "leave", type: "leave",
name, name,
reason,
stats: stats.toJSON(),
}; };
libLink.messages.playerEvent.send(this, event); libLink.messages.playerEvent.send(this, event);
libPlugin.invokeHook(this.plugins, "onPlayerEvent", event); libPlugin.invokeHook(this.plugins, "onPlayerEvent", event);
} }
async extractPlayersRequestHandler() {
const exportPlayerTimes = `/sc
local players = {}
for _, p in pairs(game.players) do
players[p.name] = p.online_time
end
rcon.print(game.table_to_json(players))`.replace(/\r?\n/g, " ");
let playerTimes = JSON.parse(await this.sendRcon(exportPlayerTimes));
for (let [name, onlineTimeTicks] of Object.entries(playerTimes)) {
let stats = this.playerStats.get(name);
if (!stats) {
stats = new PlayerStats();
this.playerStats.set(name, stats);
}
stats.onlineTimeMs = onlineTimeTicks * 1000 / 60;
let event = {
instance_id: this.id,
type: "import",
name,
stats: stats.toJSON(),
};
libLink.messages.playerEvent.send(this, event);
libPlugin.invokeHook(this.plugins, "onPlayerEvent", event);
}
}
async sendRcon(message, expectEmpty, plugin = "") { async sendRcon(message, expectEmpty, plugin = "") {
let instanceId = String(this.id); let instanceId = String(this.id);
let observeDuration = instanceRconCommandDuration.labels(instanceId).startTimer(); let observeDuration = instanceRconCommandDuration.labels(instanceId).startTimer();
@@ -492,6 +513,9 @@ class Instance extends libLink.Link {
pluginInstance.onExit(); pluginInstance.onExit();
} }
for (let player of this.playersOnline) {
this._recordPlayerLeave(player, "server_quit");
}
this._saveStats().catch(err => this.logger.error(`Error saving stats:\n${err.stack}`)); this._saveStats().catch(err => this.logger.error(`Error saving stats:\n${err.stack}`));
} }
@@ -507,17 +531,17 @@ class Instance extends libLink.Link {
} }
async _loadStats() { async _loadStats() {
let stats; let instanceStats;
try { try {
stats = JSON.parse(await fs.readFile(this.path("instance-stats.json"))); instanceStats = JSON.parse(await fs.readFile(this.path("instance-stats.json")));
} catch (err) { } catch (err) {
if (err.code === "ENOENT") { if (err.code === "ENOENT") {
return; return;
} }
throw err; throw err;
} }
this.playerStats = new Map(stats["players"]); this.playerStats = new Map(instanceStats["players"].map(([id, stats]) => [id, new PlayerStats(stats)]));
this._playerAutosaveSlot = stats["player_autosave_slot"] || 1; this._playerAutosaveSlot = instanceStats["player_autosave_slot"] || 1;
} }
async _saveStats() { async _saveStats() {
@@ -100,6 +100,13 @@ export default function InstanceViewPage(props) {
label: "Export data", label: "Export data",
}); });
} }
if (account.hasPermission("core.instance.extract_players")) {
instanceButtonMenuItems.push({
disabled: instance["status"] !== "running",
key: "extract",
label: "Extract players from save",
});
}
if (account.hasPermission("core.instance.kill")) { if (account.hasPermission("core.instance.kill")) {
instanceButtonMenuItems.push({ instanceButtonMenuItems.push({
disabled: ["unknown", "unassigned", "stopped"].includes(instance["status"]), disabled: ["unknown", "unassigned", "stopped"].includes(instance["status"]),
@@ -132,6 +139,11 @@ export default function InstanceViewPage(props) {
setExportingData(false); setExportingData(false);
}); });
} else if (key === "extract") {
libLink.messages.extractPlayers.send(
control, { instance_id: instanceId }
).catch(notifyErrorHandler("Error extracting player data"));
} else if (key === "kill") { } else if (key === "kill") {
libLink.messages.killInstance.send( libLink.messages.killInstance.send(
control, { instance_id: instanceId } control, { instance_id: instanceId }
@@ -162,6 +174,7 @@ export default function InstanceViewPage(props) {
{account.hasPermission("core.instance.load_scenario") && <LoadScenarioModal instance={instance} />} {account.hasPermission("core.instance.load_scenario") && <LoadScenarioModal instance={instance} />}
{account.hasAnyPermission( {account.hasAnyPermission(
"core.instance.export_data", "core.instance.export_data",
"core.instance.extract_players",
"core.instance.kill", "core.instance.kill",
"core.instance.delete", "core.instance.delete",
) && <Dropdown placement="bottomRight" trigger={["click"]} overlay={instanceButtonsMenu}> ) && <Dropdown placement="bottomRight" trigger={["click"]} overlay={instanceButtonsMenu}>
+92 -25
View File
@@ -1,39 +1,25 @@
import React, { useEffect, useContext, useState } from "react"; import React, { useEffect, useContext, useState } from "react";
import { useHistory, useParams } from "react-router-dom"; import { useHistory, useParams } from "react-router-dom";
import { Button, Col, Form, Input, PageHeader, Popconfirm, Popover, Row, Tag, Select, Space, Spin, Switch } from "antd"; import {
Button, Col, Descriptions, Form, Input, PageHeader, Popconfirm,
Popover, Row, Table, Tag, Select, Space, Spin, Switch,
} from "antd";
import DeleteOutlined from "@ant-design/icons/DeleteOutlined"; import DeleteOutlined from "@ant-design/icons/DeleteOutlined";
import { libLink } from "@clusterio/lib"; import { libLink } from "@clusterio/lib";
import { useAccount } from "../model/account"; import { useAccount } from "../model/account";
import { useInstanceList } from "../model/instance";
import ControlContext from "./ControlContext"; import ControlContext from "./ControlContext";
import PageLayout from "./PageLayout"; import PageLayout from "./PageLayout";
import PluginExtra from "./PluginExtra"; import PluginExtra from "./PluginExtra";
import SectionHeader from "./SectionHeader";
import { notifyErrorHandler } from "../util/notify"; import { notifyErrorHandler } from "../util/notify";
import { formatDuration } from "../util/time_format";
import { formatLastSeen, sortLastSeen, useUser } from "../model/user";
const strcmp = new Intl.Collator(undefined, { numerice: "true", sensitivity: "base" }).compare;
function useUser(name) {
let control = useContext(ControlContext);
let [user, setUser] = useState({ loading: true });
function updateUser() {
// XXX optimize by requesting only the user in question
libLink.messages.listUsers.send(control).then(result => {
let match = result.list.find(u => u.name === name);
if (!match) {
setUser({ missing: true });
} else {
setUser({ ...match, present: true });
}
});
}
useEffect(() => {
updateUser();
}, [name]);
return [user, updateUser];
}
export default function UserViewPage() { export default function UserViewPage() {
let params = useParams(); let params = useParams();
@@ -43,6 +29,7 @@ export default function UserViewPage() {
let account = useAccount(); let account = useAccount();
let control = useContext(ControlContext); let control = useContext(ControlContext);
let [instanceList] = useInstanceList();
let [user, updateUser] = useUser(userName); let [user, updateUser] = useUser(userName);
let [roles, setRoles] = useState(null); let [roles, setRoles] = useState(null);
let [form] = Form.useForm(); let [form] = Form.useForm();
@@ -105,10 +92,22 @@ export default function UserViewPage() {
</Select> </Select>
</Form.Item>; </Form.Item>;
function instanceName(id) {
let instance = instanceList.find(i => i.id === id);
return instance ? instance["name"] : id;
}
return <PageLayout nav={nav}> return <PageLayout nav={nav}>
<PageHeader <PageHeader
className="site-page-header" className="site-page-header"
title={userName} title={<Space>
{userName}
<span>
{user["is_admin"] && <Tag color="gold">Admin</Tag>}
{user["is_whitelisted"] && <Tag>Whitelisted</Tag>}
{user["is_banned"] && <Tag color="red">Banned</Tag>}
</span>
</Space>}
extra={ extra={
account.hasPermission("core.user.delete") && <Popconfirm account.hasPermission("core.user.delete") && <Popconfirm
title={<> title={<>
@@ -132,7 +131,23 @@ export default function UserViewPage() {
</Popconfirm> </Popconfirm>
} }
/> />
<Form form={form}> <Form
form={form}
labelCol={{
sm: { span: 6 },
md: { span: 6 },
lg: { span: 4 },
xl: { span: 3 },
xxl: { span: 2 },
}}
wrapperCol={{
sm: { span: 18 },
md: { span: 18 },
lg: { span: 20 },
xl: { span: 21 },
xxl: { span: 22 },
}}
>
<Form.Item <Form.Item
label="Roles" label="Roles"
> >
@@ -259,6 +274,58 @@ export default function UserViewPage() {
</Space> </Space>
</Form.Item> </Form.Item>
</Form> </Form>
<SectionHeader title="Player stats" />
<Descriptions size="small" bordered column={{ xs: 1, sm: 2, lg: 3 }}>
<Descriptions.Item label="Total play time">
{user["player_stats"]["online_time_ms"] && formatDuration(user["player_stats"]["online_time_ms"])}
</Descriptions.Item>
<Descriptions.Item label="Total join count">
{user["player_stats"]["join_count"]}
</Descriptions.Item>
<Descriptions.Item label="Last seen">
{formatLastSeen(user)}
</Descriptions.Item>
</Descriptions>
<SectionHeader title="Instance stats" />
<Table
size="small"
columns={[
{
title: "Instance",
key: "instance",
render: ([id]) => instanceName(id),
defaultSortOrder: "ascend",
sorter: (a, b) => strcmp(a[0], b[0]),
},
{
title: "Play time",
key: "playTime",
render: ([, stats]) => formatDuration(stats["online_time_ms"] || 0),
sorter: (a, b) => (a[1]["online_time_ms"] || 0) - (b[1]["online_time_ms"] || 0),
},
{
title: "Join count",
key: "joinCoint",
render: ([, stats]) => stats["join_count"] || 0,
sorter: (a, b) => (a[1]["join_count"] || 0) - (b[1]["join_count"] || 0),
responsive: ["sm"],
},
{
title: "Last seen",
key: "lastSeen",
render: ([id]) => formatLastSeen(user, id),
sorter: (a, b) => sortLastSeen(user, user, a[0], b[0]),
},
]}
dataSource={user["instance_stats"]}
pagination={false}
rowKey={([id]) => id}
onRow={([id], rowIndex) => ({
onClick: event => {
history.push(`/instances/${id}/view`);
},
})}
/>
<PluginExtra component="UserViewPage" user={user} /> <PluginExtra component="UserViewPage" user={user} />
</PageLayout>; </PageLayout>;
} }
+24 -22
View File
@@ -1,14 +1,16 @@
import React, { useEffect, useContext, useState } from "react"; import React, { useEffect, useContext, useState } from "react";
import { useHistory } from "react-router-dom"; import { useHistory } from "react-router-dom";
import { Button, Form, Input, Modal, PageHeader, Table, Tag } from "antd"; import { Button, Form, Input, Modal, PageHeader, Space, Table, Tag } from "antd";
import { libLink } from "@clusterio/lib"; import { libLink } from "@clusterio/lib";
import { useAccount } from "../model/account"; import { useAccount } from "../model/account";
import ControlContext from "./ControlContext"; import ControlContext from "./ControlContext";
import { notifyErrorHandler } from "../util/notify"; import { notifyErrorHandler } from "../util/notify";
import { formatDuration } from "../util/time_format";
import PageLayout from "./PageLayout"; import PageLayout from "./PageLayout";
import PluginExtra from "./PluginExtra"; import PluginExtra from "./PluginExtra";
import { formatLastSeen, sortLastSeen, useUserList } from "../model/user";
const strcmp = new Intl.Collator(undefined, { numerice: "true", sensitivity: "base" }).compare; const strcmp = new Intl.Collator(undefined, { numerice: "true", sensitivity: "base" }).compare;
@@ -57,14 +59,11 @@ export default function UsersPage() {
let account = useAccount(); let account = useAccount();
let control = useContext(ControlContext); let control = useContext(ControlContext);
let history = useHistory(); let history = useHistory();
let [userList] = useUserList();
let [users, setUsers] = useState([]);
let [roles, setRoles] = useState(new Map()); let [roles, setRoles] = useState(new Map());
useEffect(() => { useEffect(() => {
libLink.messages.listUsers.send(control).then(result => {
setUsers(result["list"]);
}).catch(notifyErrorHandler("Error fetching user list"));
libLink.messages.listRoles.send(control).then(result => { libLink.messages.listRoles.send(control).then(result => {
setRoles(new Map(result["list"].map(role => [role["id"], role]))); setRoles(new Map(result["list"].map(role => [role["id"], role])));
}).catch(() => { }).catch(() => {
@@ -82,7 +81,15 @@ export default function UsersPage() {
columns={[ columns={[
{ {
title: "Name", title: "Name",
dataIndex: "name", key: "name",
render: user => <Space>
{user["name"]}
<span>
{user["is_admin"] && <Tag color="gold">Admin</Tag>}
{user["is_whitelisted"] && <Tag>Whitelisted</Tag>}
{user["is_banned"] && <Tag color="red">Banned</Tag>}
</span>
</Space>,
defaultSortOrder: "ascend", defaultSortOrder: "ascend",
sorter: (a, b) => strcmp(a["name"], b["name"]), sorter: (a, b) => strcmp(a["name"], b["name"]),
}, },
@@ -92,28 +99,23 @@ export default function UsersPage() {
render: user => user.roles.map(id => <Tag key={id}>{(roles.get(id) || { name: id })["name"]}</Tag>), render: user => user.roles.map(id => <Tag key={id}>{(roles.get(id) || { name: id })["name"]}</Tag>),
}, },
{ {
title: "Admin", title: "Play time",
key: "admin", key: "playTime",
render: user => user["is_admin"] && "yes", render: user => user["player_stats"]["online_time_ms"]
sorter: (a, b) => a["is_admin"] - b["is_admin"], && formatDuration(user["player_stats"]["online_time_ms"]),
sorter: (a, b) => (a["player_stats"]["online_time_ms"] || 0) -
(b["player_stats"]["online_time_ms"] || 0),
responsive: ["lg"], responsive: ["lg"],
}, },
{ {
title: "Whitelisted", title: "Last seen",
key: "whitelisted", key: "lastSeen",
render: user => user["is_whitelisted"] && "yes", render: user => formatLastSeen(user),
sorter: (a, b) => a["is_whitelisted"] - b["is_whitelisted"], sorter: sortLastSeen,
responsive: ["lg"],
},
{
title: "Banned",
key: "banned",
render: user => user["is_banned"] && "yes",
sorter: (a, b) => a["is_banned"] - b["is_banned"],
responsive: ["lg"], responsive: ["lg"],
}, },
]} ]}
dataSource={users} dataSource={userList}
pagination={false} pagination={false}
rowKey={user => user["name"]} rowKey={user => user["name"]}
onRow={(user, rowIndex) => ({ onRow={(user, rowIndex) => ({
+128
View File
@@ -0,0 +1,128 @@
import React, { useEffect, useContext, useState } from "react";
import { Tag } from "antd";
import ControlContext from "../components/ControlContext";
import { libLink, libLogging } from "@clusterio/lib";
const { logger } = libLogging;
function calculateLastSeen(user, instanceId) {
let stats;
if (instanceId === undefined) {
stats = user["player_stats"];
} else {
let entry = (user["instance_stats"] || []).find(([id]) => id === instanceId);
if (!entry) {
return undefined;
}
stats = entry[1];
}
if (stats["last_leave_at"] > stats["last_join_at"]) {
return stats["last_leave_at"];
}
if (stats["last_join_at"]) {
return stats["last_leave_at"];
}
return undefined;
}
export function formatLastSeen(user, instanceId = undefined) {
if (user["instances"].some(id => instanceId === undefined || id === instanceId)) {
return <Tag color="green">Online</Tag>;
}
let lastSeen = calculateLastSeen(user, instanceId);
if (lastSeen === undefined) {
return undefined;
}
return new Date(lastSeen).toLocaleTimeString();
}
export function sortLastSeen(userA, userB, instanceIdA = undefined, instanceIdB = undefined) {
function epoch(user, instanceId) {
return user["instances"].some(id => instanceId === undefined || id === instanceId);
}
let epochA = epoch(userA, instanceIdA);
let epochB = epoch(userB, instanceIdB);
if (epochA !== epochB) {
return epochA - epochB;
}
let lastSeenA = calculateLastSeen(userA, instanceIdA) || 0;
let lastSeenB = calculateLastSeen(userB, instanceIdB) || 0;
return lastSeenA - lastSeenB;
}
export function useUser(name) {
let control = useContext(ControlContext);
let [user, setUser] = useState({ loading: true });
function updateUser() {
libLink.messages.getUser.send(control, { name }).then(result => {
setUser({ ...result, present: true });
}).catch(err => {
logger.error(`Failed to get user: ${err}`);
setUser({ missing: true });
});
}
useEffect(() => {
if (typeof name !== "string") {
setUser({ missing: true });
return undefined;
}
updateUser();
function updateHandler(newUser) {
setUser({ ...newUser, present: true });
}
control.onUserUpdate(name, updateHandler);
return () => {
control.offUserUpdate(name, updateHandler);
};
}, [name]);
return [user, updateUser];
}
export function useUserList() {
let control = useContext(ControlContext);
let [userList, setUserList] = useState([]);
function updateUserList() {
libLink.messages.listUsers.send(control).then(result => {
setUserList(result.list);
}).catch(err => {
logger.error(`Failed to list users:\n${err}`);
});
}
useEffect(() => {
updateUserList();
function updateHandler(newUser) {
setUserList(oldList => {
let newList = oldList.concat();
let index = newList.findIndex(u => u.name === newUser.name);
if (!newUser.is_deleted) {
if (index !== -1) {
newList[index] = newUser;
} else {
newList.push(newUser);
}
} else if (index !== -1) {
newList.splice(index, 1);
}
return newList;
});
}
control.onUserUpdate(null, updateHandler);
return () => {
control.offUserUpdate(null, updateHandler);
};
}, []);
return [userList];
}
+33
View File
@@ -0,0 +1,33 @@
const formatSecond = new Intl.NumberFormat(undefined, { style: "unit", unit: "second", unitDisplay: "narrow" }).format;
const formatMinute = new Intl.NumberFormat(undefined, { style: "unit", unit: "minute", unitDisplay: "narrow" }).format;
const formatHour = new Intl.NumberFormat(undefined, { style: "unit", unit: "hour", unitDisplay: "narrow" }).format;
const formatDay = new Intl.NumberFormat(undefined, { style: "unit", unit: "day", unitDisplay: "narrow" }).format;
/**
* Formats a duration of time in milliseconds to something human readable.
* @param {number} ms - Duration to formatDuration
* @param {object=} options - Options to control the formatting.
* @returns {string} human readable representation of the duration.
*/
export function formatDuration(ms, options = {}) {
let result = "";
if (ms < 0) {
result += "-";
ms = -ms;
}
if (ms > 86400e3) {
result += formatDay(Math.floor(ms / 86400e3));
ms %= 86400e3;
}
if (ms > 3600e3) {
result += formatHour(Math.floor(ms / 3600e3));
ms %= 3600e3;
}
if (ms > 60e3) {
result += formatMinute(Math.floor(ms / 60e3));
ms %= 60e3;
}
result += formatSecond(Math.round(ms / 1e3));
return result;
}
+61
View File
@@ -86,6 +86,7 @@ export class Control extends libLink.Link {
this.slaveUpdateHandlers = new Map(); this.slaveUpdateHandlers = new Map();
this.instanceUpdateHandlers = new Map(); this.instanceUpdateHandlers = new Map();
this.saveListUpdateHandlers = new Map(); this.saveListUpdateHandlers = new Map();
this.userUpdateHandlers = new Map();
this.logHandlers = new Map(); this.logHandlers = new Map();
this.connector.on("connect", data => { this.connector.on("connect", data => {
@@ -101,6 +102,9 @@ export class Control extends libLink.Link {
this.updateSaveListSubscriptions().catch(err => logger.error( this.updateSaveListSubscriptions().catch(err => logger.error(
`Unexpected error updating save list subscriptions:\n${err.stack}` `Unexpected error updating save list subscriptions:\n${err.stack}`
)); ));
this.updateUserSubscriptions().catch(err => logger.error(
`Unexpected error updating user subscriptions:\n${err.stack}`
));
this.updateLogSubscriptions().catch(err => logger.error( this.updateLogSubscriptions().catch(err => logger.error(
`Unexpected error updating log subscriptions:\n${err.stack}` `Unexpected error updating log subscriptions:\n${err.stack}`
)); ));
@@ -315,6 +319,63 @@ export class Control extends libLink.Link {
}); });
} }
async userUpdateEventHandler(message) {
let handlers = [].concat(
this.userUpdateHandlers.get(null) || [],
this.userUpdateHandlers.get(message.data.name) || [],
);
for (let handler of handlers) {
handler(message.data);
}
};
async onUserUpdate(name, handler) {
if (name !== null && typeof name !== "string") {
throw new Error("Invalid user name");
}
let handlers = this.userUpdateHandlers.get(name);
if (!handlers) {
handlers = [];
this.userUpdateHandlers.set(name, handlers);
}
handlers.push(handler);
if (handlers.length === 1) {
await this.updateUserSubscriptions();
}
}
async offUserUpdate(name, handler) {
let handlers = this.userUpdateHandlers.get(name);
if (!handlers || !handlers.length) {
throw new Error(`No handlers for user ${name} exist`);
}
let index = handlers.lastIndexOf(handler);
if (index === -1) {
throw new Error(`Given handler is not registered for user ${name}`);
}
handlers.splice(index, 1);
if (!handlers.length) {
this.userUpdateHandlers.delete(name);
await this.updateUserSubscriptions();
}
}
async updateUserSubscriptions() {
if (!this.connector.connected) {
return;
}
await libLink.messages.setUserSubscriptions.send(this, {
all: this.userUpdateHandlers.has(null),
names: [...this.userUpdateHandlers.keys()].filter(e => e !== null),
});
}
async logMessageEventHandler(message) { async logMessageEventHandler(message) {
let info = message.data.info; let info = message.data.info;
+2 -1
View File
@@ -98,9 +98,10 @@ module.exports = (env = {}) => ({
// Required for winston // Required for winston
"util": require.resolve("util/"), "util": require.resolve("util/"),
"os": require.resolve("os-browserify/browser"), "os": require.resolve("os-browserify/browser"),
"buffer": require.resolve("buffer/"),
// Required for zlib // Required for zlib
"assert": require.resolve("assert"), "assert": require.resolve("assert/"),
"stream": require.resolve("stream-browserify"), "stream": require.resolve("stream-browserify"),
"events": require.resolve("events/"), "events": require.resolve("events/"),
+19
View File
@@ -483,6 +483,7 @@ describe("Integration of Clusterio", function() {
let lists = ["admin", "whitelisted", "banned"]; let lists = ["admin", "whitelisted", "banned"];
it("should add and remove the given user to the list", async function() { it("should add and remove the given user to the list", async function() {
slowTest(this); slowTest(this);
getControl().userUpdates = [];
await libLink.messages.createUser.send(getControl(), { name: "list_test" }); await libLink.messages.createUser.send(getControl(), { name: "list_test" });
let user = (await getUsers()).get("list_test"); let user = (await getUsers()).get("list_test");
for (let list of lists) { for (let list of lists) {
@@ -499,6 +500,7 @@ describe("Integration of Clusterio", function() {
for (let list of lists) { for (let list of lists) {
assert.equal(user[`is_${list}`], false, `unexpected ${list} status`); assert.equal(user[`is_${list}`], false, `unexpected ${list} status`);
} }
assert.equal(getControl().userUpdates.length, 7);
}); });
it("should not create the user if not instructed to", async function() { it("should not create the user if not instructed to", async function() {
slowTest(this); slowTest(this);
@@ -512,11 +514,20 @@ describe("Integration of Clusterio", function() {
}); });
it("should create the user if instructed to", async function() { it("should create the user if instructed to", async function() {
slowTest(this); slowTest(this);
getControl().userUpdates = [];
for (let list of lists) { for (let list of lists) {
await execCtl(`user set-${list} --create test_create_${list}`); await execCtl(`user set-${list} --create test_create_${list}`);
let user = (await getUsers()).get(`test_create_${list}`); let user = (await getUsers()).get(`test_create_${list}`);
assert.equal(user && user[`is_${list}`], true, `user not created and added to ${list}`); assert.equal(user && user[`is_${list}`], true, `user not created and added to ${list}`);
} }
assert.equal(getControl().userUpdates.length, 3);
});
});
describe("instance extract-players", function() {
it("runs", async function() {
slowTest(this);
await execCtl("instance extract-players test");
}); });
}); });
@@ -868,28 +879,36 @@ describe("Integration of Clusterio", function() {
describe("user create", function() { describe("user create", function() {
it("should create the given user", async function() { it("should create the given user", async function() {
getControl().userUpdates = [];
await execCtl("user create temp"); await execCtl("user create temp");
let result = await libLink.messages.listUsers.send(getControl()); let result = await libLink.messages.listUsers.send(getControl());
let tempUser = result.list.find(user => user.name === "temp"); let tempUser = result.list.find(user => user.name === "temp");
assert(tempUser, "user was not created"); assert(tempUser, "user was not created");
assert.equal(getControl().userUpdates.length, 1);
assert.equal(getControl().userUpdates[0].name, "temp");
}); });
}); });
describe("user set-roles", function() { describe("user set-roles", function() {
it("should set the roles on the user", async function() { it("should set the roles on the user", async function() {
getControl().userUpdates = [];
await execCtl('user set-roles temp "Cluster Admin"'); await execCtl('user set-roles temp "Cluster Admin"');
let result = await libLink.messages.listUsers.send(getControl()); let result = await libLink.messages.listUsers.send(getControl());
let tempUser = result.list.find(user => user.name === "temp"); let tempUser = result.list.find(user => user.name === "temp");
assert.deepEqual(tempUser.roles, [0]); assert.deepEqual(tempUser.roles, [0]);
assert.equal(getControl().userUpdates.length, 1);
}); });
}); });
describe("user delete", function() { describe("user delete", function() {
it("should delete the user", async function() { it("should delete the user", async function() {
getControl().userUpdates = [];
await execCtl("user delete temp"); await execCtl("user delete temp");
let result = await libLink.messages.listUsers.send(getControl()); let result = await libLink.messages.listUsers.send(getControl());
let tempUser = result.list.find(user => user.name === "temp"); let tempUser = result.list.find(user => user.name === "temp");
assert(!tempUser, "user was note deleted"); assert(!tempUser, "user was note deleted");
assert.equal(getControl().userUpdates.length, 1);
assert.equal(getControl().userUpdates[0].is_deleted, true);
}); });
}); });
}); });
+8
View File
@@ -28,6 +28,7 @@ class TestControl extends libLink.Link {
this.slaveUpdates = []; this.slaveUpdates = [];
this.instanceUpdates = []; this.instanceUpdates = [];
this.saveListUpdates = []; this.saveListUpdates = [];
this.userUpdates = [];
this.connector.on("connect", () => { this.connector.on("connect", () => {
libLink.messages.setSlaveSubscriptions.send( libLink.messages.setSlaveSubscriptions.send(
@@ -39,6 +40,9 @@ class TestControl extends libLink.Link {
libLink.messages.setSaveListSubscriptions.send( libLink.messages.setSaveListSubscriptions.send(
this, { all: true, instance_ids: [] } this, { all: true, instance_ids: [] }
).catch(err => logger.error(`Error setting save list subscriptions:\n${err.stack}`)); ).catch(err => logger.error(`Error setting save list subscriptions:\n${err.stack}`));
libLink.messages.setUserSubscriptions.send(
this, { all: true, names: [] }
).catch(err => logger.error(`Error setting user subscriptions:\n${err.stack}`));
}); });
} }
@@ -63,6 +67,10 @@ class TestControl extends libLink.Link {
this.saveListUpdates.push(message.data); this.saveListUpdates.push(message.data);
} }
async userUpdateEventHandler(message) {
this.userUpdates.push(message.data);
}
async logMessageEventHandler() { } async logMessageEventHandler() { }
} }
+30
View File
@@ -85,6 +85,7 @@ describe("lib/users", function() {
test_roundtrip({ name: "user", roles: [2], token_valid_after: 12345 }); test_roundtrip({ name: "user", roles: [2], token_valid_after: 12345 });
test_roundtrip({ name: "user", is_admin: true, is_whitelisted: true }); test_roundtrip({ name: "user", is_admin: true, is_whitelisted: true });
test_roundtrip({ name: "user", is_banned: true, ban_reason: "Bad user" }); test_roundtrip({ name: "user", is_banned: true, ban_reason: "Bad user" });
test_roundtrip({ name: "user", instance_stats: [[1, { join_count: 1 }]]});
}); });
it("should ignore invalid roles", function() { it("should ignore invalid roles", function() {
let user = new libUsers.User({ name: "test", roles: [1, 4, 55] }, roles); let user = new libUsers.User({ name: "test", roles: [1, 4, 55] }, roles);
@@ -115,6 +116,35 @@ describe("lib/users", function() {
assert(!libUsers.User.onlineUsers.has(user)); assert(!libUsers.User.onlineUsers.has(user));
assert.deepEqual(user.instances, new Set()); assert.deepEqual(user.instances, new Set());
}); });
it("should calculate playerStats", function() {
let user = new libUsers.User({ name: "test", roles: [1], instance_stats: [
[1, {
join_count: 1,
online_time_ms: 60e3,
last_join_at: new Date("2020-05T12:00Z").getTime(),
last_leave_at: new Date("2020-05T12:01Z").getTime(),
last_leave_reason: "quit",
}],
[2, {
join_count: 1,
online_time_ms: 0,
last_join_at: new Date("2020-05T12:02Z").getTime(),
}],
[3, {
join_count: 2,
online_time_ms: 120e3,
last_join_at: new Date("2020-05T11:00Z").getTime(),
last_leave_at: new Date("2020-05T11:02Z").getTime(),
last_leave_reason: "afk",
}],
]}, roles);
assert.equal(user.playerStats.onlineTimeMs, 180e3);
assert.equal(user.playerStats.joinCount, 4);
assert.deepEqual(user.playerStats.lastJoinAt, new Date("2020-05T12:02Z"));
assert.deepEqual(user.playerStats.lastLeaveAt, new Date("2020-05T12:01Z"));
assert.equal(user.playerStats.lastLeaveReason, "quit");
});
describe(".checkPermission()", function() { describe(".checkPermission()", function() {
it("should correctly resolve permissions", function() { it("should correctly resolve permissions", function() {
+61 -11
View File
@@ -54,18 +54,28 @@ describe("class Instance", function() {
it("should send player_event", function() { it("should send player_event", function() {
instance._recordPlayerJoin("player"); instance._recordPlayerJoin("player");
let stats = instance.playerStats.get("player");
assert.deepEqual( assert.deepEqual(
connector.sentMessages[0], connector.sentMessages[0],
{ {
seq: 1, seq: 1,
type: "player_event_event", type: "player_event_event",
data: { type: "join", instance_id: instance.id, name: "player" }, data: {
type: "join",
instance_id: instance.id,
name: "player",
stats: {
join_count: 1,
last_join_at: stats.lastJoinAt.getTime(),
},
},
}, },
); );
}); });
it("should be idempotent", function() { it("should be idempotent", async function() {
instance._recordPlayerJoin("player"); instance._recordPlayerJoin("player");
await wait(10);
instance._recordPlayerJoin("player"); instance._recordPlayerJoin("player");
assert(instance.playersOnline.has("player"), "player was not added"); assert(instance.playersOnline.has("player"), "player was not added");
assert.equal(connector.sentMessages.length, 1); assert.equal(connector.sentMessages.length, 1);
@@ -73,8 +83,9 @@ describe("class Instance", function() {
}); });
describe("._recordPlayerLeave()", function() { describe("._recordPlayerLeave()", function() {
it("should remove player to playersOnline", function() { it("should remove player to playersOnline", async function() {
instance._recordPlayerJoin("player"); instance._recordPlayerJoin("player");
await wait(10);
instance._recordPlayerLeave("player"); instance._recordPlayerLeave("player");
assert(!instance.playersOnline.has("player"), "player was not removed"); assert(!instance.playersOnline.has("player"), "player was not removed");
}); });
@@ -87,23 +98,39 @@ describe("class Instance", function() {
assert(instance.playerStats.get("player").onlineTimeMs > 0, "no onlineTimeMs recorded"); assert(instance.playerStats.get("player").onlineTimeMs > 0, "no onlineTimeMs recorded");
}); });
it("should send player_event", function() { it("should send player_event", async function() {
instance._recordPlayerJoin("player"); instance._recordPlayerJoin("player");
instance._recordPlayerLeave("player"); await wait(10);
instance._recordPlayerLeave("player", "quit");
let stats = instance.playerStats.get("player");
assert.deepEqual( assert.deepEqual(
connector.sentMessages[1], connector.sentMessages[1],
{ {
seq: 2, seq: 2,
type: "player_event_event", type: "player_event_event",
data: { type: "leave", instance_id: instance.id, name: "player" }, data: {
type: "leave",
instance_id: instance.id,
name: "player",
reason: "quit",
stats: {
join_count: 1,
online_time_ms: stats.onlineTimeMs,
last_join_at: stats.lastJoinAt.getTime(),
last_leave_at: stats.lastLeaveAt.getTime(),
last_leave_reason: "quit",
},
},
}, },
); );
}); });
it("should be idempotent", function() { it("should be idempotent", async function() {
instance._recordPlayerJoin("player"); instance._recordPlayerJoin("player");
instance._recordPlayerLeave("player"); await wait(10);
instance._recordPlayerLeave("player"); instance._recordPlayerLeave("player", "quit");
await wait(10);
instance._recordPlayerLeave("player", "quit");
assert(!instance.playersOnline.has("player"), "player was not removed"); assert(!instance.playersOnline.has("player"), "player was not removed");
assert.equal(connector.sentMessages.length, 2); assert.equal(connector.sentMessages.length, 2);
}); });
@@ -129,12 +156,21 @@ describe("class Instance", function() {
); );
instance._recordPlayerJoin("player"); instance._recordPlayerJoin("player");
await instance._checkOnlinePlayers(); await instance._checkOnlinePlayers();
let stats = instance.playerStats.get("foo");
assert.deepEqual( assert.deepEqual(
connector.sentMessages[1], connector.sentMessages[1],
{ {
seq: 2, seq: 2,
type: "player_event_event", type: "player_event_event",
data: { type: "join", instance_id: instance.id, name: "foo" }, data: {
type: "join",
instance_id: instance.id,
name: "foo",
stats: {
join_count: 1,
last_join_at: stats.lastJoinAt.getTime(),
},
},
}, },
); );
}); });
@@ -142,13 +178,27 @@ describe("class Instance", function() {
it("should remove extra players", async function() { it("should remove extra players", async function() {
instance.server.rconCommandResults.set("/players online", "Online Players (0):\n"); instance.server.rconCommandResults.set("/players online", "Online Players (0):\n");
instance._recordPlayerJoin("player"); instance._recordPlayerJoin("player");
await wait(10);
await instance._checkOnlinePlayers(); await instance._checkOnlinePlayers();
let stats = instance.playerStats.get("player");
assert.deepEqual( assert.deepEqual(
connector.sentMessages[1], connector.sentMessages[1],
{ {
seq: 2, seq: 2,
type: "player_event_event", type: "player_event_event",
data: { type: "leave", instance_id: instance.id, name: "player" }, data: {
type: "leave",
instance_id: instance.id,
name: "player",
reason: "quit",
stats: {
join_count: 1,
online_time_ms: stats.onlineTimeMs,
last_join_at: stats.lastJoinAt.getTime(),
last_leave_at: stats.lastLeaveAt.getTime(),
last_leave_reason: "quit",
},
},
}, },
); );
}); });