Dune Awakening — Server Tools

Community tooling for the Dune: Awakening Self-Hosted Server (Steam app 4754530).

ubuntu-scripts/	Ubuntu port of Funcom's Alpine installer — systemd + k3s, preflight checks, first-install bootstrap, WAN-IP autodetect, battlegroup admin CLI.
DataExtract/	Curated reference catalog of 42 CVar namespaces (Console Variables) extracted from the server binary's public string table, organized into 38 markdown files (4 files merge PascalCase + lowercase case-variant pairs for cross-platform compatibility).

⚠ Not affiliated with Funcom — AS-IS, private-server use only

Dune Awakening is the intellectual property of Funcom Oslo A/S and the Dune IP holders (Legendary Entertainment, Herbert Properties LLC). All trademarks, characters, lore, game content, marks, and engine-string identifiers cataloged in DataExtract/ (CVar names + UCLASS paths) remain the sole property of their respective rights holders. Only the curation, organization, and annotation of that catalog plus the original ubuntu-scripts/ installer code is MIT-licensed work in this repository. You must independently purchase and Steam-install the self-hosted server tool from Funcom to use any of this. Full IP boundary in LICENSE.

Takedown / rights-holder contact

If at any point in time Funcom Oslo A/S, the Dune IP holders, or any party with a legitimate IP claim wishes for this repository to be taken down, modified, or amended in any way, please contact either sponge@unityailab.com or contact@unityailab.com directly. This repository operates in full compliance with the wishes of all named IP holders and will be removed or amended on request — no cease-and-desist or other legal escalation needed. A direct email to either address above is the fastest and simplest path to resolution.

---

Install — Ubuntu 22.04 / 24.04

# 1. Steam-install "Dune: Awakening Self-Hosted Server" (app 4754530) and cd into its install folder.
# 2. Host prerequisites:
sudo apt update && sudo apt install -y jq openssl coreutils gawk grep curl sudo
sudo add-apt-repository multiverse && sudo apt install -y steamcmd   # only for `battlegroup update`

# 3. k3s (single-binary Kubernetes — official one-liner):
curl -sfL https://get.k3s.io | sh -

# 4. Run the installer (preflight runs first; fails fast on missing deps):
bash ubuntu-scripts/setup.sh

Full prereqs, admin CLI (battlegroup status|start|stop|restart|edit|backup|...), and troubleshooting → ubuntu-scripts/README.md.

---

Tune the server — CVars

Edit scripts/setup/config/UserEngine.ini (or UserGame.ini for UCLASS sections) → run battlegroup apply-default-usersettings → restart the world.

Where	What
DataExtract/CVARS-INDEX.md	Master index — start here. 42 namespaces with one-line summaries.
DataExtract/CVARS-<namespace>.md	Per-namespace CVar lists. Top of leverage: CVARS-dw.md (vehicles + borders + fuel), CVARS-Sandworm.md, CVARS-Net.md, CVARS-Vehicle.md, CVARS-Settings.md.
DataExtract/SETTINGS-CATALOG.md	Methodology overview — how the catalog was built, [ConsoleVariables] vs [/Script/<Module>.<Class>] sections.

---

Included vs. excluded

✅ In this repo (MIT — see LICENSE)	❌ Not in this repo (and why)
ubuntu-scripts/ — clean-room bash installer + Kubernetes manifests	images/ — Funcom's container tarballs (Funcom IP, Steam delivers them)
DataExtract/CVARS-*.md × 38 — curated docs covering 42 namespaces	scripts/ — Funcom's original Alpine bash (Funcom IP)
DataExtract/SETTINGS-CATALOG.md — methodology overview	Token.txt — personal Funcom FLS JWT (identity-bound credential)
LICENSE + README.md	DataExtract/CVARS-rest.md — 547 KB uncategorized dump (not documentation)
	DataExtract/SETTINGS-CATALOG-*.txt — raw strings -el output

The .gitignore enforces all exclusions. Forks should preserve them — Funcom's content and personal credentials never belong in a derivative repo.

---

Status

Component	State
Bash port of Funcom's Alpine scripts	✅ Done
Preflight dependency check + WAN-IPv4 autodetect	✅ Done
First-install bootstrap (cert-manager + 4 operators)	✅ Tested on Multipass Ubuntu 24.04 + k3s
CVar catalog (curated subset)	✅ Published
Debian / Mint / Pop_OS verification	🔲 Untested
WSL Ubuntu / native Windows port	🔲 Future work

---

License & contributing

MIT for original work, with prominent IP-boundary notice — see LICENSE.

• ✅ Fork, modify, redistribute the original code (ubuntu-scripts/ + the curation of the CVar catalog) under MIT.
• ❌ Don't claim ownership of CVar names / UCLASS paths / Dune trademarks — those remain Funcom's.
• ❌ Don't redistribute Funcom's images/ or scripts/ — they're not in this repo and not covered.
• ❌ Don't use this to run a commercial or paid Dune Awakening server (paid access, paid boosters, pay-for-play, server-rental businesses, donation-tier-gated content, or any arrangement where money is exchanged for access to a Dune Awakening server running on this tooling). This repo is for private, non-commercial servers only — Funcom has not sanctioned commercial self-hosting and running one undermines that goodwill.

Clean-room hygiene for contributions: don't paste from Funcom's Alpine scripts. Describe the behavior in plain English in your issue/PR and the fix gets derived independently. Ran on a distro other than Ubuntu 22.04 / 24.04? Open an issue — preflight warns on unknown distros but small tweaks may be needed.