dokumentation 12 seiten

This commit is contained in:
Hikyu
2026-07-07 16:59:54 +02:00
parent 13154fbb53
commit 3a09a7285e
68 changed files with 7690 additions and 279 deletions
+34
View File
@@ -0,0 +1,34 @@
# dependencies (bun install)
node_modules
# output
out
dist
*.tgz
# code coverage
coverage
*.lcov
# logs
logs
_.log
report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
# dotenv environment variable files
.env
.env.development.local
.env.test.local
.env.production.local
.env.local
# caches
.eslintcache
.cache
*.tsbuildinfo
# IntelliJ based IDEs
.idea
# Finder (MacOS) folder config
.DS_Store
+35
View File
@@ -0,0 +1,35 @@
Default to using Bun instead of Node.js.
- Use `bun <file>` instead of `node <file>` or `ts-node <file>`
- Use `bun test` instead of `jest` or `vitest`
- Use `bun build <file.html|file.ts|file.css>` instead of `webpack` or `esbuild`
- Use `bun install` instead of `npm install` or `yarn install` or `pnpm install`
- Use `bun run <script>` instead of `npm run <script>` or `yarn run <script>` or `pnpm run <script>`
- Bun automatically loads .env, so don't use dotenv.
## APIs
- `Bun.serve()` supports WebSockets, HTTPS, and routes. Don't use `express`.
- `bun:sqlite` for SQLite. Don't use `better-sqlite3`.
- `memjs` for Memcached. Memcached has no built-in Bun client.
- `Bun.sql` for Postgres. Don't use `pg` or `postgres.js`.
- `WebSocket` is built-in. Don't use `ws`.
- Prefer `Bun.file` over `node:fs`'s readFile/writeFile
- Bun.$`ls` instead of execa.
## Datenmodell (Memcached)
Memcached kennt keine Hashes oder Sets, nur reine Key-Value-Paare. Jedes Objekt
wird deshalb unter einem flachen Key als JSON-String abgelegt. Listen (z.B. die
Items einer Region) landen als JSON-Array im Value unter einem eigenen Key.
- `player:{id}` -> JSON Objekt
- `player:{id}:weapon` / `:armor` / `:talisman` -> JSON Array mit item_ids
- `item:{id}`, `enemy:{id}`, `region:{id}` -> JSON Objekt
- `region:{id}:items` / `:enemies`, `enemy:{id}:items` -> JSON Array mit ids
- `weapon:{id}`, `armor:{id}`, `shield:{id}`, `talisman:{id}`, `item_effect:{id}`, `item_type:{id}` -> JSON Objekt
## Coding Style Preferences
- Write everything WITHOUT comments.
+8
View File
@@ -0,0 +1,8 @@
# Projekt-Dokumentation: Entwicklungsreihenfolge
1. Projekt init (gleicher Aufbau wie client-redit)
2. Docker compose mit memcached
3. Einfache verbindung (memjs)
4. Memcached getestet (mit set und get)
5. Init-Skript (db/init.ts) mit ~100 statischen Entitäten erstellt (gleiche Daten wie Redis, aber als flache JSON-Values)
6. Client (index.ts) aktualisiert Player-Daten live und liest statische Gegner-Daten
+31
View File
@@ -0,0 +1,31 @@
# client-memcached
Memcached-Variante des Ringstats-Clients. Gleicher Aufbau wie `client-redit`,
nur mit Memcached statt Redis. Da Memcached keine Hashes oder Sets kennt, liegt
jedes Objekt als flacher Key mit einem JSON-String als Value.
To install dependencies:
```bash
bun install
```
Datenbank starten:
```bash
docker compose up -d
```
Datenbank befüllen (~100 statische Entitäten):
```bash
bun run db/init.ts
```
Live-Client starten:
```bash
bun run index.ts
```
Memcached läuft auf Port `41211`, damit es parallel zu Redis und ArangoDB laufen kann.
+91
View File
@@ -0,0 +1,91 @@
import { Client } from "memjs";
const memcached = Client.create("localhost:41211");
const DB_NAME = "Memcached";
const N1 = 2000;
const N2 = 300;
const region1Enemies = ["1", "2", "3", "11", "12", "13", "14"];
const region1Items = ["1", "8", "21", "26"];
const playerObj = (i: number) => ({
id: 1,
name: "Jonas",
health: 50 + (i % 50),
stamina: 50 + (i % 50),
level: 1 + (i % 20),
region_id: 1,
});
const enemyObj = { id: 0, name: "Benchmark Enemy", health: 1000, level: 20, damage: 50 };
const itemObj = { id: 0, name: "Benchmark Item", gear_type: "weapon", gear_id: 1 };
const regionObj = { id: 1, name: "Limgrave" };
async function getJson(key: string): Promise<any> {
const { value } = await memcached.get(key);
return value ? JSON.parse(value.toString()) : null;
}
async function setJson(key: string, value: any) {
await memcached.set(key, JSON.stringify(value), {});
}
async function writeSingle(i: number) {
await setJson("bench:player:1", playerObj(i));
}
async function readSingle(_i: number) {
await getJson("bench:player:1");
}
async function readRegion(_i: number) {
const region = await getJson("region:1");
void region?.name;
const enemyIds = (await getJson("region:1:enemies")) || [];
const itemIds = (await getJson("region:1:items")) || [];
for (const id of enemyIds) await getJson(`enemy:${id}`);
for (const id of itemIds) await getJson(`item:${id}`);
}
async function writeRegion(_i: number) {
await setJson("bench:region:1", regionObj);
await setJson("bench:region:1:enemies", region1Enemies);
await setJson("bench:region:1:items", region1Items);
for (const id of region1Enemies) await setJson(`bench:enemy:${id}`, { ...enemyObj, id });
for (const id of region1Items) await setJson(`bench:item:${id}`, { ...itemObj, id });
}
async function timed(label: string, group: string, iters: number, opsPerIter: number, fn: (i: number) => Promise<void>) {
const warmup = Math.min(50, iters);
for (let i = 0; i < warmup; i++) await fn(i);
const start = performance.now();
for (let i = 0; i < iters; i++) await fn(i);
const ms = performance.now() - start;
const totalOps = iters * opsPerIter;
const opsPerSec = totalOps / (ms / 1000);
const avgMs = ms / totalOps;
return { label, group, iters, opsPerIter, totalOps, ms, opsPerSec, avgMs };
}
function fmt(r: any) {
return ` ${r.label.padEnd(11)} | ${String(r.totalOps).padStart(6)} Ops | ${r.ms.toFixed(1).padStart(9)} ms | ${Math.round(r.opsPerSec).toString().padStart(9)} Ops/s | ${r.avgMs.toFixed(4)} ms/Op`;
}
await memcached.set("__ping__", "1", {});
const w1 = await timed("Schreiben", "Anwendungsfall 1: Live-Player-Sync (1 Schluessel)", N1, 1, writeSingle);
const r1 = await timed("Lesen", "Anwendungsfall 1: Live-Player-Sync (1 Schluessel)", N1, 1, readSingle);
const r2 = await timed("Lesen", "Anwendungsfall 2: Region laden / Fast Travel (14 Schluessel)", N2, 14, readRegion);
const w2 = await timed("Schreiben", "Anwendungsfall 2: Region laden / Fast Travel (14 Schluessel)", N2, 14, writeRegion);
console.log(`\n===== Benchmark: ${DB_NAME} =====`);
console.log(w1.group);
console.log(fmt(w1));
console.log(fmt(r1));
console.log(r2.group);
console.log(fmt(r2));
console.log(fmt(w2));
console.log("##RESULT## " + JSON.stringify({ db: DB_NAME, tests: [w1, r1, r2, w2] }));
process.exit(0);
+34
View File
@@ -0,0 +1,34 @@
{
"lockfileVersion": 1,
"configVersion": 1,
"workspaces": {
"": {
"name": "client-memcached",
"dependencies": {
"memjs": "^1.3.2",
},
"devDependencies": {
"@types/bun": "latest",
"@types/memjs": "^1.3.3",
},
"peerDependencies": {
"typescript": "^5",
},
},
},
"packages": {
"@types/bun": ["@types/bun@1.3.14", "", { "dependencies": { "bun-types": "1.3.14" } }, "sha512-h1hFqFVcvAvD9j9K7ZW7vd82aSA+rTdznZa+5bwvCwqSB1jmmfLcbIWhOLx1/+boy/xmjgCs/OMUL8hRJSmnPw=="],
"@types/memjs": ["@types/memjs@1.3.3", "", { "dependencies": { "@types/node": "*" } }, "sha512-OqZuZ2T0ErrygA/WUqQjmsB1GpxAt84OCgKPKbsSWwYKA/oe/lTiqvqMgFOv/Ngl8p+nytgdhrdxJtikOgimCg=="],
"@types/node": ["@types/node@26.1.0", "", { "dependencies": { "undici-types": "~8.3.0" } }, "sha512-O0A1G3xPGy4w7AgQdAQYUlQ+BKk2Oovw8eRpofyp5KdBZULnbe+WqaOVNrm705SHphCiG4XHsACrSmPu1f+Kgw=="],
"bun-types": ["bun-types@1.3.14", "", { "dependencies": { "@types/node": "*" } }, "sha512-4N0ig0fEomHt5R0KCFWjovxow98rIoRwKolrYdCcknNwMekCXRnWEUvgu5soYV8QXtVsrUD8B95MBOZGPvr6KQ=="],
"memjs": ["memjs@1.3.2", "", {}, "sha512-qUEg2g8vxPe+zPn09KidjIStHPtoBO8Cttm8bgJFWWabbsjQ9Av9Ky+6UcvKx6ue0LLb/LEhtcyQpRyKfzeXcg=="],
"typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
"undici-types": ["undici-types@8.3.0", "", {}, "sha512-j375ScV60dom+YkPFIfTLcOiPxkN/buHz5GobjLhixFuANaNs3C9l4GmrWqejgXWJ7BbJcFYpTEUkS1Ge8bpZQ=="],
}
}
+36
View File
@@ -0,0 +1,36 @@
import { Client } from "memjs";
import { effects, types, weapons, armors, shields, talismans, items, regions, enemies } from "../../data";
const memcached = Client.create("localhost:41211");
console.log("Populating database with ~100 static Ringstats entries...");
const setJson = async (key: string, value: any) => {
await memcached.set(key, JSON.stringify(value), {});
};
const setEntities = async (prefix: string, list: any[]) => {
for (const obj of list) {
const { items, enemies, ...data } = obj;
await setJson(`${prefix}:${obj.id}`, data);
if (items && items.length > 0) {
await setJson(`${prefix}:${obj.id}:items`, items);
}
if (enemies && enemies.length > 0) {
await setJson(`${prefix}:${obj.id}:enemies`, enemies);
}
}
};
await setEntities("item_effect", effects);
await setEntities("item_type", types);
await setEntities("weapon", weapons);
await setEntities("armor", armors);
await setEntities("shield", shields);
await setEntities("talisman", talismans);
await setEntities("item", items);
await setEntities("region", regions);
await setEntities("enemy", enemies);
console.log(`Inserted ${effects.length + types.length + weapons.length + armors.length + shields.length + talismans.length + items.length + regions.length + enemies.length} primary entities into Memcached.`);
console.log("Database successfully seeded.");
process.exit(0);
@@ -0,0 +1,6 @@
services:
memcached:
image: memcached:alpine
ports:
- "41211:11211"
restart: always
+153
View File
@@ -0,0 +1,153 @@
import { Client } from "memjs";
const memcached = Client.create("localhost:41211");
const colors = {
reset: "\x1b[0m",
cyan: "\x1b[36m",
green: "\x1b[32m",
yellow: "\x1b[33m",
magenta: "\x1b[35m",
red: "\x1b[31m",
gray: "\x1b[90m",
bold: "\x1b[1m",
};
let totalRequests = 0;
function log(msg: string, color: string = colors.reset) {
const timestamp = new Date().toISOString().split('T')[1].slice(0, -1);
console.log(`${colors.gray}[${timestamp}]${colors.reset} ${color}${msg}${colors.reset}`);
}
async function getJson(key: string): Promise<any> {
const { value } = await memcached.get(key);
return value ? JSON.parse(value.toString()) : null;
}
async function setJson(key: string, value: any) {
await memcached.set(key, JSON.stringify(value), {});
}
const introMessage = "Starting Ringstats Desktop Application...";
log(introMessage, colors.cyan);
const pingStart = performance.now();
await memcached.set("__ping__", "1", {});
await memcached.get("__ping__");
totalRequests++;
log(`Connected to Ringstats Database successfully. (Reqs: 1 | Total: ${totalRequests} | Time: ${(performance.now() - pingStart).toFixed(2)}ms)`, colors.green);
log("Looking for Elden Ring process...", colors.gray);
await Bun.sleep(1500);
log("Found Elden Ring process!", colors.green);
log("Equipping initial gear...", colors.gray);
await setJson("player:1:weapon", ["1"]);
await setJson("player:1:armor", ["11"]);
await setJson("player:1:talisman", ["26"]);
totalRequests += 3;
let playerHealth = 100;
let playerStamina = 100;
let playerLevel = 1;
let currentRegionId = 1;
log("Entering live sync loop (press Ctrl+C to exit)...", colors.gray);
while (true) {
playerHealth = Math.floor(Math.max(10, playerHealth - (Math.random() * 10) + 5));
playerStamina = Math.floor(Math.max(10, playerStamina - (Math.random() * 20) + 10));
if (Math.random() > 0.9) {
playerLevel += 1;
}
if (Math.random() > 0.85) {
currentRegionId = Math.floor(Math.random() * 16) + 1;
const startTravel = performance.now();
const region = await getJson(`region:${currentRegionId}`);
const regionEnemiesIds = (await getJson(`region:${currentRegionId}:enemies`)) || [];
const regionItemsIds = (await getJson(`region:${currentRegionId}:items`)) || [];
const enemyNames = await Promise.all(regionEnemiesIds.map(async (id: string) => (await getJson(`enemy:${id}`))?.name));
const itemNames = await Promise.all(regionItemsIds.map(async (id: string) => (await getJson(`item:${id}`))?.name));
const queries = 3 + regionEnemiesIds.length + regionItemsIds.length;
totalRequests += queries;
const travelTime = (performance.now() - startTravel).toFixed(2);
console.log();
log(`>>> Fast Traveled to: [ID: ${currentRegionId}] ${region?.name} <<<`, colors.magenta + colors.bold);
log(`[Region Data] Enemies nearby: ${enemyNames.join(", ") || "None"}`, colors.magenta);
log(`[Region Data] Items nearby: ${itemNames.join(", ") || "None"}`, colors.magenta);
log(`[Stats] Query Time: ${travelTime}ms | Reqs in Block: ${queries} | Total Reqs: ${totalRequests}`, colors.gray);
console.log();
}
if (Math.random() > 0.90) {
const newWeaponId = Math.floor(Math.random() * 10) + 1;
const newArmorId = Math.floor(Math.random() * 10) + 11;
const newTalismanId = Math.floor(Math.random() * 5) + 26;
const startSwap = performance.now();
await setJson("player:1:weapon", [newWeaponId.toString()]);
await setJson("player:1:armor", [newArmorId.toString()]);
await setJson("player:1:talisman", [newTalismanId.toString()]);
const weaponName = (await getJson(`item:${newWeaponId}`))?.name;
const armorName = (await getJson(`item:${newArmorId}`))?.name;
const talismanName = (await getJson(`item:${newTalismanId}`))?.name;
totalRequests += 6;
const swapTime = (performance.now() - startSwap).toFixed(2);
console.log();
log(`>>> Gear Swapped <<<`, colors.cyan + colors.bold);
log(`Equipped: ${weaponName} | ${armorName} | ${talismanName}`, colors.cyan);
log(`[Stats] Query Time: ${swapTime}ms | Reqs in Block: 6 | Total Reqs: ${totalRequests}`, colors.gray);
console.log();
}
const startSync = performance.now();
await setJson("player:1", {
id: 1,
name: "Jonas",
health: playerHealth,
stamina: playerStamina,
level: playerLevel,
region_id: currentRegionId
});
totalRequests += 1;
const syncTime = (performance.now() - startSync).toFixed(2);
log(`[Live Sync] [ID: 1] Jonas - Lvl: ${playerLevel} | HP: ${playerHealth} | Stamina: ${playerStamina}`, colors.green);
log(`[Stats] Query Time: ${syncTime}ms | Reqs in Block: 1 | Total Reqs: ${totalRequests}`, colors.gray);
if (Math.random() > 0.7) {
const startLock = performance.now();
const enemyIds = (await getJson(`region:${currentRegionId}:enemies`)) || [];
totalRequests += 1;
const randomEnemyId = enemyIds.length > 0 ? enemyIds[Math.floor(Math.random() * enemyIds.length)] : null;
if (randomEnemyId) {
console.log();
log("--- Target Lock Detected ---", colors.red + colors.bold);
const enemyInfo = await getJson(`enemy:${randomEnemyId}`);
const dropItemIds = (await getJson(`enemy:${randomEnemyId}:items`)) || [];
const dropItemNames = await Promise.all(dropItemIds.map(async (id: string) => (await getJson(`item:${id}`))?.name));
const queries = 2 + dropItemIds.length;
totalRequests += queries;
const lockTime = (performance.now() - startLock).toFixed(2);
log(`Overlay -> [ID: ${enemyInfo.id}] ${enemyInfo.name} | Lvl: ${enemyInfo.level} | HP: ${enemyInfo.health} | DMG: ${enemyInfo.damage}`, colors.yellow);
log(`Drops -> ${dropItemNames.length > 0 ? dropItemNames.join(", ") : "None"}`, colors.yellow);
log(`[Stats] Query Time: ${lockTime}ms | Reqs in Block: ${queries + 1} | Total Reqs: ${totalRequests}`, colors.gray);
console.log();
}
}
await Bun.sleep(2000);
}
+16
View File
@@ -0,0 +1,16 @@
{
"name": "client-memcached",
"module": "index.ts",
"type": "module",
"private": true,
"dependencies": {
"memjs": "^1.3.2"
},
"devDependencies": {
"@types/bun": "latest",
"@types/memjs": "^1.3.3"
},
"peerDependencies": {
"typescript": "^5"
}
}
+29
View File
@@ -0,0 +1,29 @@
{
"compilerOptions": {
// Environment setup & latest features
"lib": ["ESNext"],
"target": "ESNext",
"module": "Preserve",
"moduleDetection": "force",
"jsx": "react-jsx",
"allowJs": true,
// Bundler mode
"moduleResolution": "bundler",
"allowImportingTsExtensions": true,
"verbatimModuleSyntax": true,
"noEmit": true,
// Best practices
"strict": true,
"skipLibCheck": true,
"noFallthroughCasesInSwitch": true,
"noUncheckedIndexedAccess": true,
"noImplicitOverride": true,
// Some stricter flags (disabled by default)
"noUnusedLocals": false,
"noUnusedParameters": false,
"noPropertyAccessFromIndexSignature": false
}
}