@opys/minecraft 0.1.2

package/README.md

@@ -0,0 +1,77 @@
+# @opys/minecraft
+
+Bridge layer that converts Mojang version JSON into Manifest artifacts and launch config. Owns the Minecraft template and config helpers.
+
+## Install
+
+```sh
+npm install @opys/minecraft @opys/core @opys/rules zod
+```
+
+## API
+
+### `resolveMinecraft(options?)`
+
+Fetches the Mojang version manifest and a specific version (or latest), then returns a `MinecraftTemplate` ready to be merged into a Manifest config.
+
+```ts
+import { resolveMinecraft } from '@opys/minecraft';
+
+const template = await resolveMinecraft({ version: '1.20.1' });
+// or omit version for latest release
+const template = await resolveMinecraft();
+
+template.artifacts; // Artifact[] — client jar, libraries, asset index, asset objects
+template.vars; // ValDefs — all interpolation variables
+template.launch; // Launch — assembled (main class + args), drop into manifest.launch
+template.jvmArgs; // Valset — JVM args alone, for composition
+template.mainClass; // Val — main class wrapped (raw at .value[0])
+template.gameArgs; // Valset — game args alone, for composition
+```
+
+### `clientToTemplate(client)`
+
+Low-level mapper if you already have a parsed `Client` from `@opys/mojang`.
+
+```ts
+import { fetchClient, clientToTemplate } from '@opys/minecraft';
+
+const { client } = await fetchClient('1.20.1');
+const template = await clientToTemplate(client);
+```
+
+### `artifactScanner(options?)`
+
+Async generator that yields `Artifact` entries by scanning a local directory. Used in `opys.config.mjs` to include mod JARs or other local files.
+
+```ts
+import { artifactScanner } from '@opys/minecraft';
+
+// yields Artifact for each file under mods/
+const scanner = artifactScanner({ dir: 'mods', into: '${root}/mods' });
+```
+
+### Config helpers
+
+Re-exported from `@opys/core` for convenience:
+
+```ts
+import { defineConfig, resolveConfig } from '@opys/minecraft';
+```
+
+## Variable reference
+
+The template sets these vars (interpolatable with `${name}`):
+
+| Variable            | Default                            |
+| ------------------- | ---------------------------------- |
+| `root`              | `.`                                |
+| `version_name`      | Minecraft version id               |
+| `version_dir`       | `${root}/versions/${version_name}` |
+| `library_directory` | `${root}/libraries`                |
+| `natives_directory` | `${version_dir}/natives`           |
+| `assets_root`       | `${root}/assets`                   |
+| `game_directory`    | `${root}/`                         |
+| `username`          | (must be supplied at launch)       |
+| `uuid`              | (must be supplied at launch)       |
+| `token`             | (must be supplied at launch)       |

package/dist/index.cjs

@@ -0,0 +1,78 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _opys_bifrost = require("@opys/bifrost");
+
+Object.defineProperty(exports, 'bifrost', {
+  enumerable: true,
+  get: function () {
+    return _opys_bifrost.resolveBifrost;
+  }
+});
+Object.defineProperty(exports, 'resolveBifrost', {
+  enumerable: true,
+  get: function () {
+    return _opys_bifrost.resolveBifrost;
+  }
+});
+var _opys_minecraft_vanilla = require("@opys/minecraft-vanilla");
+Object.keys(_opys_minecraft_vanilla).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return _opys_minecraft_vanilla[k]; }
+  });
+});
+
+var _opys_forge = require("@opys/forge");
+Object.keys(_opys_forge).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return _opys_forge[k]; }
+  });
+});
+
+var _opys_cleanroom = require("@opys/cleanroom");
+Object.keys(_opys_cleanroom).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return _opys_cleanroom[k]; }
+  });
+});
+
+var _opys_lwjgl3ify = require("@opys/lwjgl3ify");
+Object.keys(_opys_lwjgl3ify).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return _opys_lwjgl3ify[k]; }
+  });
+});
+
+var _opys_authliberty = require("@opys/authliberty");
+Object.keys(_opys_authliberty).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return _opys_authliberty[k]; }
+  });
+});
+
+var _opys_curseforge = require("@opys/curseforge");
+Object.keys(_opys_curseforge).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return _opys_curseforge[k]; }
+  });
+});
+
+var _opys_minecraft_serverlist = require("@opys/minecraft-serverlist");
+Object.keys(_opys_minecraft_serverlist).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return _opys_minecraft_serverlist[k]; }
+  });
+});
+
+var _opys_java = require("@opys/java");
+Object.keys(_opys_java).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return _opys_java[k]; }
+  });
+});

package/dist/index.d.cts

@@ -0,0 +1,10 @@
+import { BifrostAuth, BifrostOptions, resolveBifrost, resolveBifrost as bifrost } from "@opys/bifrost";
+export * from "@opys/minecraft-vanilla";
+export * from "@opys/forge";
+export * from "@opys/cleanroom";
+export * from "@opys/lwjgl3ify";
+export * from "@opys/authliberty";
+export * from "@opys/curseforge";
+export * from "@opys/minecraft-serverlist";
+export * from "@opys/java";
+export { type BifrostAuth, type BifrostOptions, bifrost, resolveBifrost };

package/dist/index.d.mts

@@ -0,0 +1,10 @@
+import { BifrostAuth, BifrostOptions, resolveBifrost, resolveBifrost as bifrost } from "@opys/bifrost";
+export * from "@opys/minecraft-vanilla";
+export * from "@opys/forge";
+export * from "@opys/cleanroom";
+export * from "@opys/lwjgl3ify";
+export * from "@opys/authliberty";
+export * from "@opys/curseforge";
+export * from "@opys/minecraft-serverlist";
+export * from "@opys/java";
+export { type BifrostAuth, type BifrostOptions, bifrost, resolveBifrost };

package/dist/index.mjs

@@ -0,0 +1,19 @@
+import { resolveBifrost, resolveBifrost as bifrost } from "@opys/bifrost";
+
+export * from "@opys/minecraft-vanilla"
+
+export * from "@opys/forge"
+
+export * from "@opys/cleanroom"
+
+export * from "@opys/lwjgl3ify"
+
+export * from "@opys/authliberty"
+
+export * from "@opys/curseforge"
+
+export * from "@opys/minecraft-serverlist"
+
+export * from "@opys/java"
+
+export { bifrost, resolveBifrost };

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@opys/minecraft",
+  "version": "0.1.2",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsdown lib/index.ts --format esm,cjs --dts --clean",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run tests/unit --passWithNoTests",
+    "test:int": "vitest run tests/integration --testTimeout=120000"
+  },
+  "dependencies": {
+    "@opys/minecraft-vanilla": "^0.1.2",
+    "@opys/forge": "^0.1.2",
+    "@opys/cleanroom": "^0.1.2",
+    "@opys/lwjgl3ify": "^0.1.2",
+    "@opys/authliberty": "^0.1.2",
+    "@opys/curseforge": "^0.1.2",
+    "@opys/bifrost": "^0.1.2",
+    "@opys/minecraft-serverlist": "^0.1.2",
+    "@opys/java": "^0.1.2"
+  },
+  "devDependencies": {
+    "@opys/core": "^0.1.2",
+    "@opys/dev": "^0.1.2",
+    "@opys/mojang": "^0.1.2",
+    "tsdown": "*",
+    "vitest": "*"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/harmoniya-net/opys.git",
+    "directory": "packages/minecraft"
+  }
+}