proxy-network

Instructions for connecting several Minecraft servers through a proxy such as Velocity, BungeeCord, or Waterfall. A proxy is the front server that sends players to connected servers such as a lobby or game server.

In plain words
What is it for?
Use it to configure server networks, lobby connections, player switching, proxy addresses, forwarding secrets, and backend server settings.
Why use it?
It prevents mismatched authentication, forwarding, and secret settings that can stop players from connecting or sharing their identity correctly.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/teddy563/mcwrench/proxy-network
Any agent
npx skills add Teddy563/mcwrench --skill proxy-network
Clone the repo
git clone --depth 1 https://github.com/Teddy563/mcwrench

Made for: Claude Code, Codex.

Per session 155 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 846 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00155 $0.00846
Opus 5 $0.00077 $0.00423
Sonnet 5 $0.00031 $0.00169
Haiku 4.5 $0.00015 $0.00085

Measured 2d ago against content hash 90cd23d4f435, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

proxy-network scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/proxy-network/SKILL.md · 78 lines

How it starts

The opening of the file, as written. The whole thing — 78 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Proxy / Network

Default proxy: Velocity (by the Paper team; TOML config, modern forwarding). Waterfall is in maintenance mode; BungeeCord is legacy. See references/velocity-modern-forwarding.md for the exact forwarding handshake — getting it wrong is the #1 network setup failure.

The forwarding contract (must all line up)

For a Velocity network with modern forwarding:

  1. Proxy velocity.toml: player-info-forwarding-mode = "modern" and forwarding-secret-file = "forwarding.secret".
  2. Secret: the proxy's forwarding.secret file contents must exactly equal each backend's paper-global.yml: proxies.velocity.secret.
  3. Backend paper-global.yml: proxies.velocity.enabled: true, matching secret, and proxies.velocity.online-mode equal to the proxy's online-mode.
  4. Backend server.properties: online-mode=false (the proxy handles authentication).
  5. Never also set spigot.yml: settings.bungeecord: true — Velocity + BungeeCord forwarding enabled together stops the backend from starting.

velocity.toml essentials

bind = "0.0.0.0:25565"
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

[servers]
lobby = "127.0.0.1:30066"
survival = "127.0.0.1:30067"
try = ["lobby"]

[forced-hosts]
"play.example.net" = ["lobby"]

[advanced]
compression-threshold = 256
login-ratelimit = 3000
  • Backends bind to internal/loopback ports; only the proxy port is public. Firewall the backend ports so players can't bypass the proxy (which would hit online-mode=false directly — a security hole).
  • try sets the initial-connect order; forced-hosts routes by hostname.

Troubleshooting map

Symptom Cause → fix
"Unable to connect you… invalid forwarding" secret mismatch or wrong forwarding mode → align secret + set modern both sides
Players join as offline UUID / skins broken backend online-mode=true, or proxies.velocity.online-mode mismatch → set backend online-mode=false, match proxy
Backend won't start BungeeCord and Velocity forwarding both enabled → disable one
Anyone can join backend directly as op backend port exposed publicly with online-mode=false → firewall to proxy only
Legacy BungeeCord network use ip_forward: true + bungeecord: true; do NOT also enable Velocity

Read the full file on GitHub · 78 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 78 lines · 155 tokens per session scan A 90cd23d4f435

Subscribe to this mod's changes

proxy-network is a skill published in the GitHub repository Teddy563/mcwrench (1 stars, last pushed 9d ago), licensed MIT. It adds 155 tokens to every session and 846 once invoked, about $0.0008 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

develop-web-game

Use when Codex is building or iterating on a web game (HTML/JS) and needs a reliable development + testing loop: implement small changes, run a Playwright-based test script with short input bursts and intentional pauses, inspect screenshots/text, and review console errors with rendergametotext.

netease-youdao/LobsterAI · 64 tokens

roblox-studio

Build and edit in Roblox Studio via the Roblox Studio MCP the RIGHT way - preflight the Studio connection, do the whole build in a few big executeluau scripts (not dozens of tiny calls), make REALISTIC terrain with the Terrain VOXEL api driven by Perlin noise (NEVER stacked Parts or concentric layers - those give ugly…

XAIHT/Tlamatini · 120 tokens

threejs-animation

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

fabioc-aloha/Alex_Skill_Mall · 40 tokens

domain-glossary

Extract a DDD-style ubiquitous language glossary from the current conversation.

kambleakash0/agent-skills · 18 tokens

spec-to-plan

Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices.

kambleakash0/agent-skills · 21 tokens

code-review

Performs a thorough code review of the current changes or a specified file / pull request. Covers correctness, security, performance, readability, and adherence to project conventions. Outputs prioritised, actionable feedback. TRIGGER when the user writes /code-review or asks for a code review, PR review, or feedback…

kambleakash0/agent-skills · 68 tokens