Skip to content

titaniumweiner/ACE-SinglePlayer

 
 

Repository files navigation

ACE Single Player Launcher

ACE Single Player Launcher turns the open-source ACEmulator ACE server into a private, local game session on Windows. One PLAY button starts an isolated MariaDB database, starts ACE.Server on your own computer, waits until the world is ready, and launches the original Asheron's Call client.

The launcher is designed for players who want a persistent personal world without manually maintaining server configuration files or entering a MariaDB root password. Characters and world state are kept between sessions, and nothing is exposed to the internet by default.

Highlights

  • Private, loopback-only ACE server and database
  • Automatic database credentials protected for the current Windows user
  • Persistent characters and world state
  • Direct Vanilla client launch, with one-click Decal support when Decal and ThwargLauncher are already installed
  • Curated server-mod library plus guarded AceForge Custom Weenie SQL imports
  • Self-contained Windows release; players do not need to install .NET
  • Pinned portable MariaDB and complete ACE World database included in the release
  • Only the original game client and its four proprietary DAT files remain user-supplied

Install

The short version is:

  1. Have a complete Asheron's Call client in one writable folder with acclient.exe and all four client DAT files. The usual path is C:\Turbine\Asheron's Call.
  2. Download the latest ACE Single Player release ZIP and extract the entire archive to a normal writable folder such as C:\Games\ACE-SinglePlayer.
  3. Run ACE.SinglePlayer.exe. If the client is not found automatically, select its folder once, then click PLAY. The first private-world import can take several minutes; later launches are much faster.

On the first Play, the launcher also creates a private server copy of the four DAT files under %LOCALAPPDATA%\ACESinglePlayer\ServerData. This prevents ACE.Server from locking the original files needed by the client and requires roughly the same amount of free disk space as the four DATs. These local copies are never included in release ZIPs or GitHub.

The portable release currently pins ACEmulator server build 1.77.4782 from upstream commit 650c5b75, ACE World v0.9.294, and MariaDB 12.3.2 LTS. Exact source URLs, hashes, and licenses are recorded in BUNDLE-MANIFEST.json and the third-party notices.

Mods

Open Server Mods in the launcher to browse the curated mod library. Installed and ready-to-install entries are listed before unavailable ports. Every entry includes a plain-language description, compatibility result, requirements, source-code links, and a saved-game safety warning. CriticalOverride is curated for one-click installation. HelloCommand, SocietyTailoring, and Expanded Cast on Strike are installable Preview ports. The last one enables the non-Aetheria equipped-item procs documented by ACEUniqueWeenies; its custom item SQL remains a separate Custom Weenies import. OptimShi's CustomClothingBase v1.11 is also an installable Preview using the author's checksum-pinned, unmodified official DLLs after a successful current-ACE loader test. Preview mods are clearly marked as not thoroughly tested in game. Other samples remain listed but unavailable until they are ported and tested. Import a Mod ZIP... can atomically install separately rebuilt, checksummed packages in the documented ACE Single Player ZIP format.

Turning a mod off stops its code after a server restart, but it does not undo experience, items, balances, character properties, or world content already saved by that mod. The launcher blocks removal of mods whose saved data may still depend on them and moves safely removable files to a recovery folder rather than deleting them. See Mod library and saved-game safety for the full policy, or How to make and import a mod to build a compatible package.

Custom Weenies and AceForge

Open Custom Weenies to import per-weenie .sql files created by AceForge. Choose an AceForge output folder or individual SQL files; the launcher previews each WCID, validates a strict list of ACE weenie-property operations, skips unsupported content, checks whether WCIDs already exist, and creates a complete ace_world backup before applying the import in one database transaction. Automatic imports require the launcher's Private Database mode.

Custom weenies become part of the saved world and do not have a one-click uninstaller. Quest, recipe, event, treasure, landscape, and client-DAT changes are not imported by this screen. See Importing AceForge custom weenies for the exact workflow and safety limits.

See the complete installation guide for prerequisites, expected file names, first-run instructions, troubleshooting, backups, and upgrade guidance.

Important

The release does not contain Asheron's Call, acclient.exe, proprietary DAT files, Decal, or ThwargLauncher. It does include the redistributable open-source ACE server, ACE World database, and MariaDB runtime with their licenses and source links. Never upload your client or DAT files when sharing builds or reporting problems.

Project status

This is a Windows-focused single-player launcher built as a maintained fork of ACE. Vanilla launch and the private-database path are the primary supported workflow. Decal integration is optional, and Chorizite integration is reserved for future work. See the architecture, build instructions, and roadmap for technical details.

Privacy and local files

User-specific settings and protected credentials are stored under %LOCALAPPDATA%\ACESinglePlayer. Private database files, settings, logs, client files, and DAT files are ignored by Git and rejected by the public packaging script. Public release packages also exclude debug symbols that could reveal the build computer's source path.

Upstream project

ACE Single Player is based on ACEmulator ACE and remains under ACE's AGPL-3.0 license. The original ACE project information follows.


ACEmulator Core Server

Discord

Build status: GitHub last commit (master) Windows CI docker build

Download Latest Server Release GitHub Release Date Download Latest World Database Release GitHub Release Date

GitHub All Releases GitHub All Releases Docker Pulls

ACEmulator is a custom, completely from-scratch open source server implementation for Asheron's Call built on C#

  • MySQL and MariaDB are used as the database engine.
  • Latest client supported.
  • License

Disclaimer

This project is for educational and non-commercial purposes only, use of the game client is for interoperability with the emulated server.

  • Asheron's Call was a registered trademark of Turbine, Inc. and WB Games Inc which has since expired.
  • ACEmulator is not associated or affiliated in any way with Turbine, Inc. or WB Games Inc.

Getting Started

Extended documentation can be found on the project Wiki.

Contributions

  • Contributions in the form of issues and pull requests are welcomed and encouraged.
  • The preferred way to contribute is to fork the repo and submit a pull request on GitHub.
  • Code style information can be found on the Wiki.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Bug Reports

  • Please use the issue tracker provided by GitHub to send us bug reports.
  • You may also discuss issues and bug reports on our discord listed below.

Contact

About

One-click Windows single-player launcher for ACEmulator ACE with a private local MariaDB world, persistent characters, and optional Decal support.

Topics

Resources

License

Code of conduct

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages

  • C# 99.7%
  • Other 0.3%