@opys/dgpuj

The discrete GPU for opys. dgpuj() adds dgpuj, a small program that starts Java on the fast graphics card of a laptop that has two.

npm install -D @opys/dev @opys/dgpuj @opys/java @opys/minecraft-vanilla

Example

// opys.config.mjs
import { defineConfig } from '@opys/dev';
import { dgpuj } from '@opys/dgpuj';
import { java } from '@opys/java';
import { minecraft } from '@opys/minecraft-vanilla';

export default defineConfig({
  output: 'game.opys',
  plugins: [minecraft({ version: '1.21.1' }), java({ version: '21' }), dgpuj()],
  manifest: {
    command: '@dgpuj.bin',
    args: [
      '@minecraft.command',
      '@minecraft.jvmArgs',
      '@minecraft.mainClass',
      '@minecraft.gameArgs',
    ],
    workdir: '${game_directory}',
  },
});

Options

Option	What it does
version	Left out, the release this version of opys was written for. Or 'latest', 'prerelease', or a tag ('v0.6.0').
platforms	Which platforms get it.
repo, token, apiBase	Where it is downloaded from, and a GitHub token.

What it adds

opys build turns the plugin into these parts of the manifest.

Files · one archive per platform

Five archives. rules pick one, and extract takes the executable out.

// in the manifest
{
  "path": "${dgpuj_dir}/dgpuj-x86_64-pc-windows-msvc.zip",
  "source": { "url": "https://github.com/harmoniya-net/dgpuj/releases/download/v0.6.0/dgpuj-x86_64-pc-windows-msvc.zip" },
  "size": 947,
  "rules": ["allow.os.windows", "allow.arch.x86_64"],
  "integrity": { "sha256": "d90a21ccc99625b450b897b10ac34bd4e36b7fbf03cbd7172133160f2d794fa4" },
  "extract": { "file": "dgpuj.exe", "into": "${dgpuj_dir}/dgpuj.exe" }
}

Launch

One piece, the executable. It goes in command, and the java it is to run goes first in args.

// in the manifest
"launch": {
  // '@dgpuj.bin'
  "command": "${dgpuj_bin}",
  "args": [
    // '@minecraft.command'
    "${java_bin}",
    // … the game's own arguments
  ]
}

Variables

Where the executable is, per OS.

// in the manifest
"vars": {
  "dgpuj_dir": "${root}/dgpuj",
  "dgpuj_bin": [
    { "value": "${dgpuj_dir}/dgpuj.exe", "rules": "allow.os.windows" },
    { "value": "${dgpuj_dir}/dgpuj", "rules": "allow.os.linux" },
    { "value": "${dgpuj_dir}/dgpuj", "rules": "allow.os.osx" }
  ]
}

Every option

Each option, in each way it is used.

// the release this version of opys names: no lookup, the same in every build
dgpuj();

// the newest release or prerelease, looked up at build, or one exact tag
dgpuj({ version: 'latest' });
dgpuj({ version: 'prerelease' });
dgpuj({ version: 'v0.6.0' });

// only some platforms; DEFAULT_PLATFORMS is exported by @opys/dgpuj
dgpuj({ platforms: DEFAULT_PLATFORMS.filter((p) => p.os === 'windows') });

// a fork, with a GitHub token for the rate limit
dgpuj({
  repo: 'my-org/dgpuj',
  token: process.env.GITHUB_TOKEN,
  apiBase: 'https://github.example.com/api/v3',
});

Documentation

• The full page: every option, and why it works this way
• The format: what a manifest is made of

Part of opys. Also exported by @opys/minecraft.