cyberia 2.98.0 → 2.99.1

package/.env.development

@@ -41,5 +41,6 @@ NFS_EXPORT_PATH=changethis
 NVIDIA_API_KEY=changethis
 DEFAULT_ADMIN_EMAIL=admin@default.net
 DEFAULT_ADMIN_PASSWORD=changethis
+DEFAULT_SSH_PORT=22
 BASE_API=api
 DEV_PROXY_PORT_OFFSET=200

package/.env.production

@@ -50,6 +50,7 @@ NPM_USER=changethis
 NPM_PASSWORD=changethis
 POSTMAN_EMAIL=admin@default.net
 POSTMAN_PASSWORD=changethis
+DEFAULT_SSH_PORT=22
 BASE_API=api
 CERTBOT_LIVE_PATH=changethis
 CERTBOT_LIVE_PATH_WINDOWS=changethis

package/.env.test

@@ -41,5 +41,6 @@ NFS_EXPORT_PATH=changethis
 NVIDIA_API_KEY=changethis
 DEFAULT_ADMIN_EMAIL=admin@default.net
 DEFAULT_ADMIN_PASSWORD=changethis
+DEFAULT_SSH_PORT=22
 BASE_API=api
 DEV_PROXY_PORT_OFFSET=200

package/.github/workflows/engine-cyberia.cd.yml

@@ -59,4 +59,33 @@ jobs:
             echo "Starting remote sync and deploy"
             cd /home/dd/engine
             sudo -n -- /bin/bash -lc "node bin run pull"
-            sudo -n -- /bin/bash -lc "node bin run sync --cron-jobs none dd-cyberia,1,,localhost/rockylinux9-underpost:v2.8.846"
+            sudo -n -- /bin/bash -lc "node bin run sync --cron-jobs none --timeout-response 300000ms dd-cyberia,1,,localhost/rockylinux9-underpost:v2.98.3 --cmd 'npm install -g npm@11.2.0,npm install -g underpost,underpost secret underpost --create-from-file /etc/config/.env.production,underpost start --build --run dd-cyberia production'"
+  init:
+    if: github.repository == 'underpostnet/engine' && startsWith(github.event.head_commit.message, 'cd(ssh-init-engine-cyberia)')
+    name: Remote SSH init deployment
+    runs-on: ubuntu-latest
+    steps:
+      - name: Run remote deploy via SSH
+        uses: appleboy/ssh-action@v1.2.2
+        with:
+          # Remote host (secret)
+          host: ${{ secrets.SSH_HOST }}
+          # Remote user (secret)
+          username: ${{ secrets.SSH_USERNAME }}
+          # Private key (secret) — the PEM contents (not a path)
+          key: ${{ secrets.SSH_PRIV_KEY }}
+          # Remote port (optional)
+          port: ${{ secrets.SSH_PORT }}
+          # Optional: increase timeout for long-running commands
+          command_timeout: 60m
+          # Optional: if your private key has a passphrase, add:
+          # passphrase: ${{ secrets.SSH_KEY_PASSPHRASE }}
+          # Commands to run on the remote VM
+          script: |
+            set -e
+            echo "Starting init deploy"
+            cd /home/dd/engine
+            sudo -n -- /bin/bash -lc "node bin run pull"
+            sudo -n -- /bin/bash -lc "node bin deploy dd-cyberia production --kubeadm --sync --build-manifest --image 'localhost/rockylinux9-underpost:v2.98.3' --timeout-response 300000ms --versions green --replicas 1 --cmd 'npm install -g npm@11.2.0,npm install -g underpost,underpost secret underpost --create-from-file /etc/config/.env.production,underpost start --build --run dd-cyberia production'"
+            sudo -n -- /bin/bash -lc "node bin deploy dd-cyberia production --kubeadm --disable-update-proxy"
+            sudo -n -- /bin/bash -lc "node bin monitor dd-cyberia production --ready-deployment --promote --timeout-response 300000ms --versions green --replicas 1"

package/.vscode/settings.json

@@ -4,10 +4,10 @@
   "explorer.compactFolders": false,
   "javascript.preferences.importModuleSpecifierEnding": "js",
   "[javascript]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
   },
   "[python]": {
-    "editor.defaultFormatter": "ms-python.python"
+    "editor.defaultFormatter": "ms-python.python",
   },
   "cSpell.words": [
     "adminer",
@@ -40,7 +40,6 @@
     "htmls",
     "inet",
     "inlt",
-    "ipfs",
     "Itemledger",
     "jsonld",
     "lampp",
@@ -72,16 +71,16 @@
     "webroot",
     "xampp",
     "xfwd",
-    "youtu"
+    "youtu",
   ],
   "[php]": {
-    "editor.defaultFormatter": "bmewburn.vscode-intelephense-client"
+    "editor.defaultFormatter": "bmewburn.vscode-intelephense-client",
   },
   "[xml]": {
-    "editor.defaultFormatter": "redhat.vscode-xml"
+    "editor.defaultFormatter": "redhat.vscode-xml",
   },
 
   "files.watcherExclude": {
-    "**/target": true
-  }
+    "**/target": true,
+  },
 }

package/README.md

@@ -14,17 +14,21 @@
 
 This Command Line Interface (CLI) is a core tool for the **Cyberia Network Object Layer Engine**, specifically designed for processing, generating, and managing game assets, primarily **Object Layer** elements like skins, floors, and weapons.
 
-It handles image asset quantization, generates data matrices and color palettes, and persists the resulting structured data into the game's database.
+It handles image asset quantization, generates data matrices and color palettes, creates separate render frame documents, and persists the resulting structured data into the game's database with top-level references to render frames and atlas sprite sheets.
 
 ## What this tool does
 
-The CLI scans the local asset folders (`./src/client/public/cyberia/assets/{type}/{id}/{direction}/{frame}`), quantizes images to a tile matrix and color palette, and persists the resulting object-layer documents to your configured MongoDB. It also supports reconstructing a visual PNG from the stored matrix for inspection.
+The CLI scans the local asset folders (`./src/client/public/cyberia/assets/{type}/{id}/{direction}/{frame}`), quantizes images to a tile matrix and color palette, creates separate ObjectLayerRenderFrames documents, and persists the resulting object-layer documents with references to your configured MongoDB. It also supports reconstructing a visual PNG from the stored matrix for inspection.
 
 Key features:
 
 - Walks the asset directory structure and processes PNG/GIF files.
 - Produces `frame_matrix` and `map_color` arrays from images.
-- Saves processed objects to the `ObjectLayer` model in MongoDB.
+- Saves processed objects to the `ObjectLayer` model with top-level references to `ObjectLayerRenderFrames`.
+- Creates separate `ObjectLayerRenderFrames` documents for render data.
+- Links ObjectLayers to AtlasSpriteSheet documents via top-level `atlasSpriteSheetId`.
+- Generates unique UUID v4 seeds (via `crypto.randomUUID()`) for SHA256 hash uniqueness.
+- Generates SHA256 hash using `fast-json-stable-stringify` for deterministic serialization.
 - Reconstructs PNG frames from stored tile data for debugging.
 
 ## Getting Started
@@ -66,8 +70,139 @@ cyberia ol --import all
 
 ## Visualize a processed frame
 
-Reconstructs and opens a PNG from the processed frame data. The input format is `objectLayerId_direction_frameIndex`.
+Reconstructs and opens a PNG from the database-stored frame data. Requires item-id as the first positional argument, followed by direction and frame index in the format `[direction]_[frameIndex]`.
 
 ```bash
-cyberia ol --import skin --show-frame anon_08_0
+# Show frame with default direction and frame (08_0)
+cyberia ol anon --show-frame
+
+# Show specific direction and frame
+cyberia ol anon --show-frame 08_0
+
+# Show different directions
+cyberia ol anon --show-frame 02_0  # up_idle
+cyberia ol anon --show-frame 04_1  # left_idle (second frame)
+```
+
+**Valid direction codes:**
+- `08`: down_idle, none_idle, default_idle
+- `18`: down_walking
+- `02`: up_idle
+- `12`: up_walking
+- `04`: left_idle, up_left_idle, down_left_idle
+- `14`: left_walking, up_left_walking, down_left_walking
+- `06`: right_idle, up_right_idle, down_right_idle
+- `16`: right_walking, up_right_walking, down_right_walking
+
+This command:
+- Finds the ObjectLayer by item-id
+- Loads the associated ObjectLayerRenderFrames document
+- Reconstructs the PNG from the stored `frame_matrix` and `map_color`
+- Saves it temporarily to disk as `{item-id}_{direction}_{frame}.png`
+- Opens it with Firefox for visual inspection
+
+### Generate Atlas Sprite Sheet
+
+Consolidates all frames (8 directions, multiple modes) from an object layer's render frames into a single optimized PNG atlas with metadata.
+
+```bash
+# Generate atlas sprite sheet with auto-calculated dimensions (recommended)
+cyberia ol anon --to-atlas-sprite-sheet
+
+# Generate atlas with custom dimensions (manual override)
+cyberia ol anon --to-atlas-sprite-sheet 4096
+
+
+```
+
+This command:
+- Finds the ObjectLayer by item-id or MongoDB `_id`
+- Loads the associated ObjectLayerRenderFrames document
+- **Auto-calculates optimal atlas dimensions** based on total frame count (8 directions × all animation modes)
+- Generates a consolidated PNG with all animation frames properly arranged
+- Stores the PNG in the File collection
+- Creates/updates an AtlasSpriteSheet document with frame positions
+- Updates the ObjectLayer with top-level `atlasSpriteSheetId` reference
+- Uses power-of-2 dimensions for GPU efficiency
+
+**Atlas Dimension Calculation:**
+- **Auto (default)**: Dynamically calculates optimal size based on:
+  - Total number of frames across all directions and modes
+  - Individual frame dimensions
+  - Grid layout to minimize wasted space
+  - Power-of-2 optimization (1024, 2048, 4096, etc.)
+- **Manual override**: Specify exact dimension (e.g., `--to-atlas-sprite-sheet 4096`)
+
+**Common Atlas Sizes:**
+- **1024x1024**: ~6-10 frames
+- **2048x2048**: ~20-40 frames (typical for character sprites)
+- **4096x4096**: ~80-160 frames (complex animations)
+- **8192x8192**: Maximum, for extreme cases
+
+The tool automatically warns if frames exceed the specified dimension and suggests a larger size.
+
+### View Atlas Sprite Sheet
+
+Opens the consolidated atlas sprite sheet PNG for inspection.
+
+```bash
+# Show atlas sprite sheet by item-id
+cyberia ol anon --show-atlas-sprite-sheet
+
+```
+
+This command:
+- Finds the ObjectLayer by item-id
+- Retrieves the associated AtlasSpriteSheet via top-level `atlasSpriteSheetId` or by matching `metadata.itemKey`
+- Saves it temporarily to disk
+- Opens it with Firefox for visual inspection
+- Displays atlas dimensions in the console
+
+## Common Workflows
+
+### Complete Asset Processing Pipeline
+
+Process assets from source files through to atlas generation:
+
+```bash
+# 1. Import object layers from asset directories
+cyberia ol --import skin
+
+# 2. Verify a specific frame was imported correctly
+cyberia ol anon --show-frame 08_0
+
+# 3. Generate optimized atlas sprite sheet
+cyberia ol anon --to-atlas-sprite-sheet
+
+# 4. View the generated atlas
+cyberia ol anon --show-atlas-sprite-sheet
+```
+
+### Debugging Asset Issues
+
+```bash
+# Check if frame data is correct for all directions
+cyberia ol anon --show-frame 08_0  # down_idle
+cyberia ol anon --show-frame 02_0  # up_idle
+cyberia ol anon --show-frame 04_0  # left_idle
+cyberia ol anon --show-frame 06_0  # right_idle
+
+# Verify walking animations
+cyberia ol anon --show-frame 18_0  # down_walking
+cyberia ol anon --show-frame 12_0  # up_walking
+cyberia ol anon --show-frame 14_0  # left_walking
+cyberia ol anon --show-frame 16_0  # right_walking
+```
+
+### Working with Multiple Items
+
+```bash
+# Import multiple types at once
+cyberia ol --import skin,floor,weapon
+
+# Process individual items
+cyberia ol sword --show-frame 08_0
+cyberia ol sword --to-atlas-sprite-sheet
+cyberia ol shield --show-frame 08_0
+cyberia ol shield --to-atlas-sprite-sheet
 ```

package/bin/build.js

@@ -159,6 +159,7 @@ const { DefaultConf } = await import(`../conf.${confName}.js`);
       recursive: true,
     });
 
+  const originPackageJson = JSON.parse(fs.readFileSync(`./package.json`, 'utf8'));
   const packageJson = JSON.parse(fs.readFileSync(`${basePath}/package.json`, 'utf8'));
   packageJson.name = repoName.replace('engine-', '');
 
@@ -171,16 +172,31 @@ const { DefaultConf } = await import(`../conf.${confName}.js`);
       );
       delete packageJson.bin.underpost;
       packageJson.bin.cyberia = 'bin/index.js';
-      packageJson.keywords = ['cyberia', 'object-layer', 'game-engine', 'assets-management', 'web3'];
+      packageJson.keywords = [
+        'cyberia',
+        'object-layer',
+        'game-engine',
+        'assets-management',
+        'web3',
+        'atlas-sprite-sheet',
+      ];
       packageJson.description = 'Cyberia Engine - Object Layer and Assets Management Microservice';
+      const { CyberiaDependencies } = await import(`../src/client/components/cyberia-portal/CommonCyberiaPortal.js`);
+      packageJson.dependencies = {
+        ...packageJson.dependencies,
+        ...CyberiaDependencies,
+      };
       fs.writeFileSync(`${basePath}/bin/index.js`, fs.readFileSync(`./bin/cyberia.js`, 'utf8'), 'utf8');
       fs.copyFileSync(`./src/api/object-layer/README.md`, `${basePath}/README.md`);
       fs.copySync(`./hardhat`, `${basePath}/hardhat`);
       fs.copySync(`./hardhat/white-paper.md`, `${basePath}/white-paper.md`);
-      fs.copySync(
-        `./src/client/ssr/pages/CyberiaServerMetrics.js`,
-        `${basePath}/src/client/ssr/pages/CyberiaServerMetrics.js`,
-      );
+      for (const path of [
+        '/src/client/ssr/pages/CyberiaServerMetrics.js',
+        '/src/server/object-layer.js',
+        '/src/server/atlas-sprite-sheet-generator.js',
+      ])
+        fs.copySync(`.${path}`, `${basePath}${path}`);
+
     default:
       break;
   }