Change to new preprocessor style

This commit is contained in:
Cooldude2606 committed 2024-02-27 23:07:38 +00:00
1 parent ec19d5456e
commit 62abfa903b
37 files changed
+692 -2193

No files matched your search

@@ -1,3 +0,0 @@
dist/
node_modules/
package-lock.json
File diff suppressed because it is too large. Load diff
@@ -1,2 +0,0 @@
webpack.config.js
dist/web/build
@@ -1,26 +1,38 @@
"use strict";
const lib = require("@clusterio/lib");
const { BaseControllerPlugin } = require("@clusterio/controller");
const { PluginExampleEvent, PluginExampleRequest,/*/ [subscribable] /*/ ExampleSubscribableUpdate, ExampleSubscribableValue/*/ [] /*/ } = require("./messages");
class ControllerPlugin extends BaseControllerPlugin {// [subscribable] //
const {
PluginExampleEvent, PluginExampleRequest,
//%if controller & web // Subscribing requires web content and the controller
ExampleSubscribableUpdate, ExampleSubscribableValue,
//%endif
} = require("./messages");
class ControllerPlugin extends BaseControllerPlugin {
//%if controller & web // Subscribing requires web content and the controller
exampleDatabase;
storageDirty = false;
// [] //
//%endif
async init() {
this.controller.handle(PluginExampleEvent, this.handlePluginExampleEvent.bind(this));
this.controller.handle(PluginExampleRequest, this.handlePluginExampleRequest.bind(this));// [subscribable] //
this.controller.handle(PluginExampleRequest, this.handlePluginExampleRequest.bind(this));
//%if controller & web // Subscribing requires web content and the controller
this.controller.subscriptions.handle(ExampleSubscribableUpdate, this.handleExampleSubscription.bind(this));
this.exampleDatabase = new Map(); // If needed, replace with loading from database file // [] //
this.exampleDatabase = new Map(); // If needed, replace with loading from database file
//%endif
}
async onControllerConfigFieldChanged(field, curr, prev) {
this.logger.info(`controller::onControllerConfigFieldChanged ${field}`);
}// [instance] //
}
//%if instance
async onInstanceConfigFieldChanged(instance, field, curr, prev) {
this.logger.info(`controller::onInstanceConfigFieldChanged ${instance.id} ${field}`);
}// [] //
}
//%endif
async onSaveData() {
this.logger.info("controller::onSaveData");
@@ -44,14 +56,16 @@ class ControllerPlugin extends BaseControllerPlugin {// [subscribable] //
myResponseString: request.myString,
myResponseNumbers: request.myNumberArray,
};
}// [subscribable] //
}
//%if controller & web // Subscribing requires web content and the controller
async handleExampleSubscription(request) {
const values = [...this.exampleDatabase.values()].filter(
value => value.updatedAtMs > request.lastRequestTimeMs,
);
return values.length ? new ExampleSubscribableUpdate(values) : null;
}// [] //
}
//%endif
}
module.exports = {
+1 -1
View File
@@ -5,7 +5,7 @@ const { PluginExampleEvent, PluginExampleRequest } = require("./messages");
/* eslint-disable no-console */
const pluginCommands = new CommandTree({
name: "// plugin_name //", description: "The default description I forgot to change",
name: "__plugin_name__", description: "The default description I forgot to change",
});
pluginCommands.add(new Command({
+47 -24
View File
@@ -1,79 +1,102 @@
"use strict";
const lib = require("@clusterio/lib");
const messages = require("./messages");
const Messages = require("./messages");
lib.definePermission({
name: "// plugin_name //.example.permission.event",
name: "__plugin_name__.example.permission.event",
title: "Example permission event",
description: "My plugin's example permission that I forgot to remove",
});
lib.definePermission({
name: "// plugin_name //.example.permission.request",
name: "__plugin_name__.example.permission.request",
title: "Example permission request",
description: "My plugin's example permission that I forgot to remove",
});// [subscribable] //
});
//%if controller & web // Subscribing requires web content and the controller
lib.definePermission({
name: "// plugin_name //.example.permission.subscribe",
name: "__plugin_name__.example.permission.subscribe",
title: "Example permission subscribe",
description: "My plugin's example permission that I forgot to remove",
});// [] //// [web] //
});
//%endif
//%if web
lib.definePermission({
name: "// plugin_name //.page.view",
name: "__plugin_name__.page.view",
title: "Example page view permission",
description: "My plugin's example page permission that I forgot to remove",
});// [] //
});
//%endif
const plugin = {
name: "// plugin_name //",
title: "// plugin_name //",
description: "I didn't update my description",// [entry_points] //
// entry_points //
// [] //// [controller] //
description: "I didn't update my description",
//%if controller
controllerEntrypoint: "./dist/node/controller",
controllerConfigFields: {
"// plugin_name //.myControllerField": {
"__plugin_name__.myControllerField": {
title: "My Controller Field",
description: "This should be removed",
type: "string",
initialValue: "Remove Me",
},
},// [] //// [host] //
},
//%endif
//%if host
hostEntrypoint: "./dist/node/host",
hostConfigFields: {
"// plugin_name //.myHostField": {
"__plugin_name__.myHostField": {
title: "My Host Field",
description: "This should be removed",
type: "string",
initialValue: "Remove Me",
},
},// [] //// [instance] //
},
//%endif
//%if instance
instanceEntrypoint: "./dist/node/instance",
instanceConfigFields: {
"// plugin_name //.myInstanceField": {
"__plugin_name__.myInstanceField": {
title: "My Instance Field",
description: "This should be removed",
type: "string",
initialValue: "Remove Me",
},
},// [] //// [ctl] //
},
//%endif
//%if ctl
ctlEntrypoint: "./dist/node/ctl",
controlConfigFields: {
"// plugin_name //.myControlField": {
"__plugin_name__.myControlField": {
title: "My Control Field",
description: "This should be removed",
type: "string",
initialValue: "Remove Me",
},
},// [] //
},
//%endif
messages: [
messages.PluginExampleEvent,
messages.PluginExampleRequest,// [subscribable] //
messages.ExampleSubscribableUpdate,// [] //
Messages.PluginExampleEvent,
Messages.PluginExampleRequest,
//%if controller & web // Subscribing requires web content and the controller
Messages.ExampleSubscribableUpdate,
//%endif
],
//%if controller | web // The controller always includes web entry even if there is no content
webEntrypoint: "./web",
routes: [],
//%endif
};
module.exports = {
plugin,
PluginExampleEvent,
PluginExampleRequest,
};
@@ -6,8 +6,10 @@ const { PluginExampleEvent, PluginExampleRequest } = require("./messages");
class InstancePlugin extends BaseInstancePlugin {
async init() {
this.instance.handle(PluginExampleEvent, this.handlePluginExampleEvent.bind(this));
this.instance.handle(PluginExampleRequest, this.handlePluginExampleRequest.bind(this));// [module] //
this.instance.server.handle("ipc-// plugin_name //-plugin_example_ipc", this.handlePluginExampleIPC.bind(this));// [] //
this.instance.handle(PluginExampleRequest, this.handlePluginExampleRequest.bind(this));
//%if module
this.instance.server.handle("ipc-__plugin_name__-plugin_example_ipc", this.handlePluginExampleIPC.bind(this));
//%endif
}
async onInstanceConfigFieldChanged(field, curr, prev) {
@@ -27,8 +29,10 @@ class InstancePlugin extends BaseInstancePlugin {
}
async handlePluginExampleEvent(event) {
this.logger.info(JSON.stringify(event));// [module] //
this.sendRcon("/sc ipc_// plugin_name //.foo()");// [] //
this.logger.info(JSON.stringify(event));
//%if module
this.sendRcon("/sc ipc___plugin_name__.foo()");
//%endif
}
async handlePluginExampleRequest(request) {
@@ -37,11 +41,13 @@ class InstancePlugin extends BaseInstancePlugin {
myResponseString: request.myString,
myResponseNumbers: request.myNumberArray,
};
}// [module] //
}
//%if module
async handlePluginExampleIPC(event) {
this.logger.info(JSON.stringify(event));
}// [] //
}
//%endif
}
module.exports = {
+14 -10
View File
@@ -6,8 +6,8 @@ class PluginExampleEvent {
static type = "event";
static src = ["host", "control"];
static dst = ["controller", "host", "instance"];
static plugin = "// plugin_name //";
static permission = "// plugin_name //.example.permission.event";
static plugin = "__plugin_name__";
static permission = "__plugin_name__.example.permission.event";
constructor(myString, myNumberArray) {
this.myString = myString;
@@ -28,8 +28,8 @@ class PluginExampleRequest {
static type = "request";
static src = ["host", "control"];
static dst = ["controller", "host", "instance"];
static plugin = "// plugin_name //";
static permission = "// plugin_name //.example.permission.request";
static plugin = "__plugin_name__";
static permission = "__plugin_name__.example.permission.request";
constructor(myString, myNumberArray) {
this.myString = myString;
@@ -49,7 +49,8 @@ class PluginExampleRequest {
"myResponseString": Type.String(),
"myResponseNumbers": Type.Array(Type.Number()),
}));
}// [subscribable] //
}
//%if controller & web // Subscribing requires web content and the controller
class ExampleSubscribableValue {
constructor(id, updatedAtMs, isDeleted) {
@@ -73,8 +74,8 @@ class ExampleSubscribableUpdate {
static type = "event";
static src = "controller";
static dst = "control";
static plugin = "// plugin_name //";
static permission = "// plugin_name //.example.permission.subscribe";
static plugin = "__plugin_name__";
static permission = "__plugin_name__.example.permission.subscribe";
constructor(updates) {
this.updates = updates;
@@ -87,11 +88,14 @@ class ExampleSubscribableUpdate {
static fromJSON(json) {
return new this(json.updates.map(update => ExampleSubscribableValue.fromJSON(update)));
}
}// [] //
}
//%endif
module.exports = {
PluginExampleEvent,
PluginExampleRequest,// [subscribable] //
PluginExampleRequest,
//%if controller & web // Subscribing requires web content and the controller
ExampleSubscribableValue,
ExampleSubscribableUpdate,// [] //
ExampleSubscribableUpdate,
//%endif
};
@@ -1,52 +0,0 @@
local clusterio_api = require("modules/clusterio/api")
--- Top level module table, contains event handlers and public methods
local MyModule = {
events = {},
on_nth_tick = {},
}
--- global is 'synced' between players, you should use your plugin name to avoid conflicts
-- setupGlobalData should either be removed or called during clusterio_api.events.on_server_startup
local globalData = {}
local function setupGlobalData()
if global["// plugin_name //"] == nil then
global["// plugin_name //"] = {
-- starting values go here
}
end
globalData = global["// plugin_name //"]
end
--- Public methods should be available though your top level module table
function MyModule.foo()
game.print("foo")
end
--- Private methods should be local to the file, this will prevent others from calling it
local function bar()
game.print("bar")
end
--- Clusterio provides a few custom events, on_server_startup is the most useful and should be used in place of on_load
MyModule.events[clusterio_api.events.on_server_startup] = function(event)
setupGlobalData()
game.print(game.table_to_json(event))
end
--- Factorio events are accessible through defines.events, you can have one handler per event per module
MyModule.events[defines.events.on_player_crafted_item] = function(event)
game.print(game.table_to_json(event))// [instance] //
clusterio_api.send_json("// plugin_name //-plugin_example_ipc", {
tick = game.tick, player_name = game.get_player(event.player_index).name
})// [] //
end
--- Nth tick is a special case that requires its own table, the index represents the time period between calls in ticks
MyModule.on_nth_tick[300] = function()
game.print(game.tick)
bar()
end
--- Always return the top level module table from control, this is how clusterio will access your event handlers
return MyModule
@@ -1,12 +0,0 @@
{
"name": "// plugin_name //",
"load": [
"control.lua"
],
"require": [
// [instance] //"module_exports.lua"// [] //
],
"dependencies": [
]
}
@@ -1,8 +0,0 @@
local MyModule = require("./control")// [instance] //
--- Can contain anything you plan to use with send_rcon including functions, modules, or data
-- luacheck: globals ipc_// plugin_name //
ipc_// plugin_name // = MyModule// [] //
--- Can contain anything you want to allow other plugins to have access to, this example exposes the whole module
return MyModule
@@ -1,29 +0,0 @@
{
"name": "// plugin_name //",
"version": "0.1.0",
"description": "",
"main": "index.js",
"scripts": {
"prepare": "// prepare //"
},
"engines": {
"node": ">=18"
},
"peerDependencies": {
"@clusterio/lib": "^2.0.0-alpha.14"
},
"devDependencies": {
// dev_dependencies //
"@clusterio/lib": "^2.0.0-alpha.14"
},
"dependencies": {
"@sinclair/typebox": "^0.30.4"
},
"publishConfig": {
"access": "public"
},
"keywords": [
"clusterio",
"factorio"
]
}
@@ -1,46 +1,68 @@
const { useContext, useEffect, useState/*/ [subscribable] /*/, useCallback, useSyncExternalStore/*/ [] /*/ } = require("react");
// const { } = require("antd");
import React, {
useContext, useEffect, useState,
//%if controller & web // Subscribing requires web content and the controller
useCallback, useSyncExternalStore,
//%endif
} from "react";
const {
// import {
//
// } from "antd";
import {
BaseWebPlugin, PageLayout, Control, ControlContext, notifyErrorHandler,
} = require("@clusterio/web_ui");
} from "@clusterio/web_ui";
const lib = require("@clusterio/lib");
const { PluginExampleEvent, PluginExampleRequest/*/ [subscribable] /*/, ExampleSubscribableUpdate/*/ [] /*/ } = require("../messages");
import {
PluginExampleEvent, PluginExampleRequest,
//%if controller & web // Subscribing requires web content and the controller
ExampleSubscribableUpdate,
//%endif
} from "../messages";
import * as lib from "@clusterio/lib";
function MyTemplatePage() {
let control = useContext(ControlContext);// [subscribable] //
const plugin = control.plugins.get("// plugin_name //");
const [subscribableData, synced] = plugin.useSubscribableData();// [] //
let control = useContext(ControlContext);
//%if controller & web // Subscribing requires web content and the controller
const plugin = control.plugins.get("__plugin_name__");
const [subscribableData, synced] = plugin.useSubscribableData();
//%endif
return <PageLayout nav={[{ name: "// plugin_name //" }]}>
<h2>// plugin_name //</h2>// [subscribable] //
Synced: {String(synced)} Data: {JSON.stringify([...subscribableData.values()])}// [] //
return <PageLayout nav={[{ name: "__plugin_name__" }]}>
<h2>__plugin_name__</h2>
//%if controller & web // Subscribing requires web content and the controller
Synced: {String(synced)} Data: {JSON.stringify([...subscribableData.values()])}
//%endif
</PageLayout>;
}
class WebPlugin extends BaseWebPlugin {// [subscribable] //
class WebPlugin extends BaseWebPlugin {
//%if controller & web // Subscribing requires web content and the controller
subscribableData = new lib.EventSubscriber(ExampleSubscribableUpdate, this.control);
// [] //
//%endif
async init() {
this.pages = [
{
path: "/// plugin_name //",
sidebarName: "// plugin_name //",
permission: "// plugin_name //.page.view",
path: "/__plugin_name__",
sidebarName: "__plugin_name__",
permission: "__plugin_name__.page.view",
content: <MyTemplatePage/>,
},
];
this.control.handle(PluginExampleEvent, this.handlePluginExampleEvent.bind(this));
this.control.handle(PluginExampleRequest, this.handlePluginExampleRequest.bind(this));
}// [subscribable] //
}
//%if controller & web // Subscribing requires web content and the controller
useSubscribableData() {
const control = useContext(ControlContext);
const subscribe = useCallback((callback) => this.subscribableData.subscribe(callback), [control]);
return useSyncExternalStore(subscribe, () => this.subscribableData.getSnapshot());
}// [] //
}
//%endif
async handlePluginExampleEvent(event) {
this.logger.info(JSON.stringify(event));
@@ -1,28 +0,0 @@
"use strict";
const path = require("path");
const webpack = require("webpack");
const { merge } = require("webpack-merge");
const common = require("@clusterio/web_ui/webpack.common");
module.exports = (env = {}) => merge(common(env), {
context: __dirname,
entry: "./web/index.jsx",
output: {
path: path.resolve(__dirname, "dist", "web"),
},
plugins: [
new webpack.container.ModuleFederationPlugin({
name: "// plugin_name //",
library: { type: "var", name: "plugin_// plugin_name //" },
exposes: {
"./": "./info.js",
"./package.json": "./package.json",
},
shared: {
"@clusterio/lib": { import: false },
"@clusterio/web_ui": { import: false },
},
}),
],
});