Shoal

This is a text-based UI launcher for the following Call of Duty mod clients:

• AlterWare
• Plutonium

It supports the following games:

• Call of Duty: World at War
• Call of Duty: Modern Warfare 2
• Call of Duty: Modern Warfare 3
• Call of Duty: Black Ops
• Call of Duty: Black Ops II
• Call of Duty: Ghosts
• Call of Duty: Advanced Warfare

Download

• Click here to download the latest prebuilt exe release.

Project Example:

Features:

• Supports all games within the official Plutonium Launcher and Alterware Launchers
• Game mode selection
• Testing Branch Support
• Theme customization
• Global game argument list
• Game-specific argument lists
• Username selection
• Utility Buttons
• Automatic game running, with configureable delay

App Details:

• Made for Windows Terminal: The app is designed for Windows Terminal but also works in the standard command prompt.
• Font Size: Designed for font size 8. Future versions will adjust the font size automatically.
• Platform Support: Currently tested on Windows, with future plans for atleast modern Ubuntu and Debian Linux installs.
• Other: Currently only supports Plutonium's LAN mode, if possible, I will change this in the future. Currently token generation is all that is left to do this.

Join the Discord

If you have any problems, suggestions, or just want to chat, feel free to join the Discord

Suggestions

If you have ideas or suggestions for the tool feel free to open a suggestions issue or mention it in the discord.

Bug Reports

If you encounter a bug or issue, please submit a report on the issues page. When creating an issue, please provide as much information as possible, including:

• Steps to reproduce the issue
• What you expect to happen, versus what is happening
• Any error messages or logs
• Your system operating system

Contributing

Contributions are always appreciated, but please keep in mind the following:

• Before coding new features, try to make an issue to see if the idea/implementation needs any tweaking, or is out of scope
• Try to make sure your new code passes lint checks from ruff, this isn't super strict, but preferred
• For textual, we do not use tcss, so for your styling please use python

Technologies:

• Textual - Framework for creating TUI (Text User Interfaces) with Python.
• Hatch - Modern project management tool for Python.
• UV - An extremely fast Python package and project manager, written in Rust.
• PyInstaller - Tool to convert Python programs into standalone executables.
• Ruff - Fast Python linter and code formatting tool.
• PyProjectDevTools - A set of generic tools for Python applications, using Hatch, UV, and PyInstaller.

License: