youugiuhiuh/Wuthering_Waves_Private_Server
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
630 commits 1 branch 113 tags 80 MiB
  • PureBasic 90.4%
  • Rust 8.3%
  • Go 1.2%
Find a file
Exact
youugiuhiuh 91497c29e5
Some checks failed
Build and Release / build-and-release (push) Has been cancelled
Details
Repo Mirror Sync / Mirror to Codeberg (push) Has been cancelled
Details
Repo Mirror Sync / Mirror to GitLab (push) Has been cancelled
Details
Repo Mirror Sync / Mirror to Forgejo (push) Has been cancelled
Details
Update repo-sync.yml
2026-06-08 11:05:58 +09:00
.agents/skills New 2026-06-07 20:53:39 +08:00
.claude feat: add Wuthering_Waves_Private_Server ECC bundle (.claude/homunculus/instincts/inherited/Wuthering_Waves_Private_Server-instincts.yaml) 2026-05-04 03:33:21 +00:00
.codegraph 1 2026-05-23 16:55:09 +08:00
.codex feat: add Wuthering_Waves_Private_Server ECC bundle (.codex/agents/docs-researcher.toml) 2026-05-04 03:33:20 +00:00
.github Update repo-sync.yml 2026-06-08 11:05:58 +09:00
.opencode/plans New 2026-06-07 20:53:39 +08:00
.vscode Initial commit on solo branch 2026-03-15 19:27:37 +08:00
docs/superpowers feat(kcpmask): complete v26.6.1 adaptation 2026-06-02 12:17:26 +08:00
fodder Initial commit on solo branch 2026-03-15 19:27:37 +08:00
go/installer chore(deps): bump golang.org/x/crypto (#69) 2026-05-22 06:10:58 +00:00
proto feat: add Protobuf definition for SNI domain list 2026-04-07 22:56:44 +08:00
References Initial commit on solo branch 2026-03-15 19:27:37 +08:00
rust chore: bump version to 2.7.8 2026-06-07 22:15:13 +08:00
scripts feat: add one-time VPS repair script for conntrack and firewall cleanup 2026-06-07 21:01:40 +08:00
skills Initial commit on solo branch 2026-03-15 19:27:37 +08:00
sni_tester Merge branch 'main' into dependabot/go_modules/sni_tester/golang.org/x/net-0.55.0 2026-05-22 06:12:10 +00:00
tools/bin2pb feat(sni): convert bin files to protobuf format, remove old bin directories 2026-04-08 10:15:34 +08:00
.build.yml refactor: remove public repo, publish to source repo only 2026-04-24 19:57:57 +08:00
.gitignore remove 2026-04-29 17:37:05 +08:00
.pre-commit-config.yaml Initial commit on solo branch 2026-03-15 19:27:37 +08:00
AGENTS.md 1 2026-05-23 17:01:52 +08:00
LICENSE Initial commit on solo branch 2026-03-15 19:27:37 +08:00
README.md Update README.md 2026-04-25 10:24:00 +08:00
skills-lock.json New 2026-06-07 20:53:39 +08:00

README.md

WWPS Control Stack

License: AGPL v3 Platform Status

Overview

This is the control plane used to deploy, initialize, update, and operate the WWPS environment on Linux VPS hosts.

An experimental self-hosted server emulator project for Wuthering Waves, focused on quick deployment, simple management, and stable runtime behavior on Linux VPS environments.

Features

  • One-command bootstrap installer
  • Remote management workflow after deployment
  • User profile and runtime configuration management
  • Deployment asset rotation and maintenance utilities
  • Network tuning and recovery helpers
  • Suitable for lightweight VPS environments

Components

  • rust/tgbot: Telegram-based management bot
  • go/installer: bootstrap installer and update entrypoint
  • rust/version-sync: release/version synchronization helper
  • sni_tester: standalone SNI and connectivity testing utility

Quick Start

Recommended environment:

  • Ubuntu 20.04+
  • Debian 10+
  • amd64 or arm64 Linux VPS

Install with:

wget -O /root/installer "https://github.com/youugiuhiuh/Wuthering_Waves_Private_Server/releases/latest/download/installer" && chmod +x /root/installer && /root/installer

Repository Contents

Releases include:

  • installer: bootstrap program
  • tgbot: management-side executable

Use the installer first. It will prepare the runtime environment and deploy the required components automatically.

Operations

After installation, the management interface can be used for:

  • service status checks
  • user and configuration maintenance
  • deployment updates
  • runtime diagnostics
  • security and recovery operations

Build

Rust bot

cd rust/tgbot
cargo build --release

Go installer

cd go/installer
go build -o installer .

SNI tester

cd sni_tester
go build .

Release Flow

The CI/CD workflows build release artifacts from this repository and create releases with tgbot and installer binaries.

Supported CI/CD platforms:

  • GitHub Actions (.github/workflows/public-release.yml)
  • GitLab CI (.gitlab-ci.yml)
  • Azure Pipelines (azure-pipelines.yml)
  • Bitbucket Pipelines (bitbucket-pipelines.yml)
  • SourceHut Builds (.build.yml)

Trigger by bumping version in rust/tgbot/Cargo.toml and pushing to default branch, or run manually with version input.

Scope

The project focuses on:

  • host bootstrap and secure initialization
  • Telegram-side operations and maintenance workflows
  • inbound configuration generation and lifecycle management
  • routing, geo data, certificate, and kernel/network maintenance helpers

Disclaimer

This project is intended for educational and technical research purposes only. Do not use it for commercial activities.

Wuthering Waves is a trademark of its respective owner. Please support the official game.