mcserver-cli 4.2.0__tar.gz → 4.4.0__tar.gz

{mcserver_cli-4.2.0 → mcserver_cli-4.4.0}/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+
+## [4.4.0] - 2026-11-04
+
+### Added
+
+- `op remove` to remove players based on UUIDs or names
+- Player count to `whitelist list`
+
+### Fixes
+
+- Wrong description for `whitelist remove`
+- Fixing the wrong singular text in whitelist when no whitelisted player
+
+## [4.3.0] - 2026-11-02
+
+### Added
+
+- `whitelist remove` to remove players based on UUIDs or names
+
 ## [4.2.0] - 2026-11-02
 
 ### Changed
@@ -228,8 +247,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Better mod conflict error
 - Faster mod resolving
 
-[unreleased]: https://github.com/Othecat35/MCServer/compare/v4.2.0...HEAD
-[4.2.0]: https://github.com/Othecat35/MCServer/compare/v4.0.0...v4.1.0
+[unreleased]: https://github.com/Othecat35/MCServer/compare/v4.4.0...HEAD
+[4.4.0]: https://github.com/Othecat35/MCServer/compare/v4.3.0...v4.4.0
+[4.3.0]: https://github.com/Othecat35/MCServer/compare/v4.2.0...v4.3.0
+[4.2.0]: https://github.com/Othecat35/MCServer/compare/v4.1.0...v4.2.0
 [4.1.0]: https://github.com/Othecat35/MCServer/compare/v4.0.0...v4.1.0
 [4.0.0]: https://github.com/Othecat35/MCServer/compare/v3.0.0...v4.0.0
 [3.0.0]: https://github.com/Othecat35/MCServer/compare/v2.0.0...v3.0.0

{mcserver_cli-4.2.0 → mcserver_cli-4.4.0}/NOTES.txt

@@ -390,4 +390,5 @@ it can be the default config of all your new Minecraft server derived from
 and yea
 
 
-2026-11-01, let's start not using AI?
+Ah yes... rcon, and also swrver management protocol.
+Don't forget to add a warning fof whitelist remove if the server is running to run whitelist remove

{mcserver_cli-4.2.0 → mcserver_cli-4.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: mcserver-cli
-Version: 4.2.0
+Version: 4.4.0
 Summary: A CLI tool to manage Minecraft: Java Edition servers.
 Project-URL: Homepage, https://github.com/Othecat35/MCServer
 Project-URL: Repository, https://github.com/Othecat35/MCServer.git
@@ -25,8 +25,7 @@ Supported platforms:
 - JRE (depends on Minecraft version)
 
 ## How to install
-- Using pip:
-1. Run `pip install mcserver-cli`
+- Using pip: Run `pip install mcserver-cli`
 
 - System-wide (Requires root): 
 1. Download the `mcserver` script file from GitHub releases
@@ -44,28 +43,36 @@ Supported platforms:
 ## Usage
 - Initialize a server: `mcserver init [options]`
 - List operator players: `mcserver op list`
+- Revoke operator players: `mcserver op revoke <players>`
+- Search projects: `mcserver search [query] [options]`
 - Show information about projects: `mcserver show <projects>`
 - Start the server: `mcserver start`
-- Stop the server: `mcserver stop [--force-stop]`
+- Stop the server: `mcserver stop`
 - List whitelisted players: `mcserver whitelist list`
+- Remove whitelisted players: `mcserver whitelist remove <players>`
 
-### Example
+### Examples
 - Create and start a Fabric 1.20.1 server on current directory
 ```bash
 mcserver init --game-version=1.20.1 --loader=fabric
 mcserver start
 ```
 
+- Search top 50 Fabric mods for Minecraft 1.20.1 in modrinth
+```bash
+mcserver search --loader=fabric --game-version=1.20.1 --limit=50
+```
+
 - List all operator and whitelisted players on current directory
 ```bash
 mcserver op list
 mcserver whitelist list
 ```
 
-- Stop (sigterm) a server on current directory
+- Stop a server on current directory with sigterm
 ```bash
 mcserver stop
 ```
 
 ## Note
-This is a **Personal Project**, things may be unstable.
+This is a **Personal Project** by Othecat35, so don't expect much from me :>

{mcserver_cli-4.2.0 → mcserver_cli-4.4.0}/README.md

@@ -12,8 +12,7 @@ Supported platforms:
 - JRE (depends on Minecraft version)
 
 ## How to install
-- Using pip:
-1. Run `pip install mcserver-cli`
+- Using pip: Run `pip install mcserver-cli`
 
 - System-wide (Requires root): 
 1. Download the `mcserver` script file from GitHub releases
@@ -31,28 +30,36 @@ Supported platforms:
 ## Usage
 - Initialize a server: `mcserver init [options]`
 - List operator players: `mcserver op list`
+- Revoke operator players: `mcserver op revoke <players>`
+- Search projects: `mcserver search [query] [options]`
 - Show information about projects: `mcserver show <projects>`
 - Start the server: `mcserver start`
-- Stop the server: `mcserver stop [--force-stop]`
+- Stop the server: `mcserver stop`
 - List whitelisted players: `mcserver whitelist list`
+- Remove whitelisted players: `mcserver whitelist remove <players>`
 
-### Example
+### Examples
 - Create and start a Fabric 1.20.1 server on current directory
 ```bash
 mcserver init --game-version=1.20.1 --loader=fabric
 mcserver start
 ```
 
+- Search top 50 Fabric mods for Minecraft 1.20.1 in modrinth
+```bash
+mcserver search --loader=fabric --game-version=1.20.1 --limit=50
+```
+
 - List all operator and whitelisted players on current directory
 ```bash
 mcserver op list
 mcserver whitelist list
 ```
 
-- Stop (sigterm) a server on current directory
+- Stop a server on current directory with sigterm
 ```bash
 mcserver stop
 ```
 
 ## Note
-This is a **Personal Project**, things may be unstable.
+This is a **Personal Project** by Othecat35, so don't expect much from me :>

{mcserver_cli-4.2.0 → mcserver_cli-4.4.0}/pyproject.toml

@@ -28,8 +28,3 @@ packages = ["src/mcserver"]
 
 [tool.hatch.version]
 path = "src/mcserver/__init__.py"
-
-[tool.ruff.lint]
-ignore = [
-  "LOG015"
-]

mcserver_cli-4.4.0/src/mcserver/__init__.py

@@ -0,0 +1 @@
+__version__ = "4.4.0"

{mcserver_cli-4.2.0 → mcserver_cli-4.4.0}/src/mcserver/cli.py

@@ -1,115 +1,119 @@
-def main() -> int:
-    import argparse
-    import sys
-    from types import FunctionType
-
-    from . import __version__
-    from .modrinth.shared import search_sort_index
-    from .shared import loader_list
-
-    def bound_int(min_integer: int, max_integer: int | None = None) -> FunctionType:
-        def parse(cli_string: str) -> int:
-            try:
-                integer = int(cli_string)
-            except ValueError:
-                raise argparse.ArgumentTypeError(f"{cli_string} is not an integer")
-
-            if integer < min_integer:
-                raise argparse.ArgumentTypeError(
-                    f"{integer} must be higher than or equal to {min_integer}"
-                )
-            if max_integer is not None and integer > max_integer:
-                raise argparse.ArgumentTypeError(
-                    f"{integer} must be between {min_integer} and {max_integer} (inclusive)"
-                )
-            return integer
-
-        return parse
-
-    def command_function(args: argparse.Namespace) -> int:
-        command_name: str = args.command_name
-
-        match command_name:
-            case "add":
-                from .commands import add
-
-                return add(args)
-            case "import":
-                from .commands import import_setup
-
-                return import_setup(args)
-            case "help":
-                from .commands import print_help
-
-                return print_help(args)
-            case "init":
-                from .commands import init
-
-                return init(args)
-            case "list":
-                from .commands import list_projects
-
-                return list_projects(args)
-            case "op_grant":
-                from .commands import op_grant
-
-                return op_grant(args)
-            case "op_list":
-                from .commands import op_list
-
-                return op_list(args)
-            case "op_revoke":
-                from .commands import op_revoke
-
-                return op_revoke(args)
-            case "remove":
-                from .commands import remove_projects
-
-                return remove_projects(args)
-            case "search":
-                from .commands import search
-
-                return search(args)
-            case "show":
-                from .commands import show
-
-                return show(args)
-            case "start":
-                from .commands import start
-
-                return start(args)
-            case "status":
-                from .commands import server_status
-
-                return server_status(args)
-            case "stop":
-                from .commands import stop
-
-                return stop(args)
-            case "update":
-                from .commands import update_projects
-
-                return update_projects(args)
-            case "whitelist_add":
-                from .commands import whitelist_add
-
-                return whitelist_add(args)
-            case "whitelist_list":
-                from .commands import whitelist_list
-
-                return whitelist_list(args)
-            case "whitelist_remove":
-                from .commands import whitelist_remove
-
-                return whitelist_remove(args)
-            case _:
-                import logging as log
-
-                log.error(f"Unknown command: {command_name}")
-                return 1
+import argparse
+import sys
+from types import FunctionType
 
-    # Parser Setup
+from . import __version__
+from .modrinth.shared import search_sort_index
+from .shared import loader_list
+
+
+def bound_int(min_integer: int, max_integer: int | None = None) -> FunctionType:
+    def parse(cli_string: str) -> int:
+        try:
+            integer = int(cli_string)
+        except ValueError:
+            raise argparse.ArgumentTypeError(f"{cli_string} is not an integer")
+
+        if integer < min_integer:
+            raise argparse.ArgumentTypeError(
+                f"{integer} must be higher than or equal to {min_integer}"
+            )
+        if max_integer is not None and integer > max_integer:
+            raise argparse.ArgumentTypeError(
+                f"{integer} must be between {min_integer} and {max_integer} (inclusive)"
+            )
+        return integer
+
+    return parse
+
+
+def command_function(args: argparse.Namespace) -> int:
+    command_name: str = args.command_name
+
+    match command_name:
+        case "add":
+            from .commands import add_projects
+
+            return add_projects(args)
+        case "import":
+            from .commands import import_setup
+
+            return import_setup(args)
+        case "help":
+            from .commands import print_help
+
+            return print_help(args)
+        case "init":
+            from .commands import initialize_server
+
+            return initialize_server(args)
+        case "list":
+            from .commands import list_projects
+
+            return list_projects(args)
+        case "op_grant":
+            from .commands import op_grant
+
+            return op_grant(args)
+        case "op_list":
+            from .commands import op_list
+
+            return op_list(args)
+        case "op_revoke":
+            from .commands import op_revoke
+
+            return op_revoke(args)
+        case "remove":
+            from .commands import remove_projects
+
+            return remove_projects(args)
+        case "search":
+            from .commands import search_projects
+
+            return search_projects(args)
+        case "show":
+            from .commands import show_projects
+
+            return show_projects(args)
+        case "start":
+            from .commands import start_server
 
+            return start_server(args)
+        case "status":
+            from .commands import server_status
+
+            return server_status(args)
+        case "stop":
+            from .commands import stop_server
+
+            return stop_server(args)
+        case "update":
+            from .commands import update_projects
+
+            return update_projects(args)
+        case "whitelist_add":
+            from .commands import whitelist_add
+
+            return whitelist_add(args)
+        case "whitelist_list":
+            from .commands import whitelist_list
+
+            return whitelist_list(args)
+        case "whitelist_remove":
+            from .commands import whitelist_remove
+
+            return whitelist_remove(args)
+        case _:
+            import logging
+
+            logger = logging.getLogger(__name__)
+
+            logger.error(f"Unknown command: {command_name}")
+            return 1
+
+
+def main() -> int:
+    # Parser Setup
     parser = argparse.ArgumentParser(
         prog="mcserver",
         description="A CLI tool for managing Minecraft: Java Edition servers.",
@@ -220,6 +224,18 @@ def main() -> int:
 
     op_list_command.set_defaults(command_name="op_list")
 
+    # 'op revoke'
+    op_revoke_command = op_subcommands.add_parser(
+        "revoke",
+        help="Revoke operator players permission",
+        description="Revoke operator players permission.",
+    )
+
+    op_revoke_command.set_defaults(command_name="op_revoke")
+    op_revoke_command.add_argument(
+        "players", nargs="+", type=str, help="List of player names or UUIDs"
+    )
+
     # 'search' command
     search_command = commands.add_parser(
         "search",
@@ -328,5 +344,17 @@ def main() -> int:
 
     whitelist_list_command.set_defaults(command_name="whitelist_list")
 
+    # 'whitelist remove'
+    whitelist_remove_command = whitelist_subcommands.add_parser(
+        "remove",
+        help="Remove players from the whitelist",
+        description="Remove players from the whitelist.",
+    )
+
+    whitelist_remove_command.set_defaults(command_name="whitelist_remove")
+    whitelist_remove_command.add_argument(
+        "players", nargs="+", type=str, help="List of player names or UUIDs"
+    )
+
     args = parser.parse_args()
     return args.func(args)

mcserver_cli-4.4.0/src/mcserver/commands/__init__.py

@@ -0,0 +1,39 @@
+from .add_projects import run as add_projects
+from .import_setup import run as import_setup
+from .initialize_server import run as initialize_server
+from .list_projects import run as list_projects
+from .op_grant import run as op_grant
+from .op_list import run as op_list
+from .op_revoke import run as op_revoke
+from .print_help import run as print_help
+from .remove_projects import run as remove_projects
+from .search_projects import run as search_projects
+from .server_status import run as server_status
+from .show_projects import run as show_projects
+from .start_server import run as start_server
+from .stop_server import run as stop_server
+from .update_projects import run as update_projects
+from .whitelist_add import run as whitelist_add
+from .whitelist_list import run as whitelist_list
+from .whitelist_remove import run as whitelist_remove
+
+__all__ = [
+    "add_projects",
+    "import_setup",
+    "initialize_server",
+    "list_projects",
+    "op_grant",
+    "op_list",
+    "op_revoke",
+    "print_help",
+    "remove_projects",
+    "search_projects",
+    "server_status",
+    "show_projects",
+    "start_server",
+    "stop_server",
+    "update_projects",
+    "whitelist_add",
+    "whitelist_list",
+    "whitelist_remove",
+]

mcserver_cli-4.2.0/src/mcserver/commands/add.py → mcserver_cli-4.4.0/src/mcserver/commands/add_projects.py

@@ -3,7 +3,7 @@ from argparse import Namespace
 
 from .. import config, paths, shared
 from ..modrinth import apis as modrinth_apis
-from ..modrinth import project_records, slug_index
+from ..modrinth import project_records
 from ..resolver import (
     Dependency,
     human_to_resolver,
@@ -13,13 +13,18 @@ from ..resolver import (
 
 logger = logging.getLogger(__name__)
 
-def add(args: Namespace) -> int:
+
+def run(args: Namespace) -> int:
     projects: list[str] = args.projects
 
     if not (paths.configs_dir / "server.json").exists():
-        logger.error("Configuration file for server does not exist, is server initialized?")
+        logger.error(
+            "Configuration file for server does not exist, is server initialized?"
+        )
 
-    server_config = config.read_config("server", shared.default_configs["server"]["format_version"])
+    server_config = config.read_config(
+        "server", shared.default_configs["server"]["format_version"]
+    )
     game_version = server_config["game_version"]
     loader_name = server_config["loader"]["name"]
 
@@ -35,11 +40,12 @@ def add(args: Namespace) -> int:
         dependencies: list[Dependency] = []
         if project_records.record_exists(project_id):
             project_record = project_records.read_record(project_id)
-            for dependency_id, dependency_type in project_record["dependencies"].items():
-                dependencies.append({
-                    "project_id": dependency_id,
-                    "dependency_type": dependency_type
-                })
+            for dependency_id, dependency_type in project_record[
+                "dependencies"
+            ].items():
+                dependencies.append(
+                    {"project_id": dependency_id, "dependency_type": dependency_type}
+                )
 
         else:
             project_version = modrinth_apis.get_project_versions(
@@ -64,7 +70,9 @@ def add(args: Namespace) -> int:
 
         return human_to_resolver(dependencies)
 
-    resolved_dependencies = resolve_dependencies(projects, get_dependencies, required_only)
+    resolved_dependencies = resolve_dependencies(
+        projects, get_dependencies, required_only
+    )
     print(resolved_dependencies)
     return 0
 
@@ -154,7 +162,6 @@ def add(args: Namespace) -> int:
     #     ]
     #     return a
 
-
     # server_config = config.read_config(
     #     "server", shared.default_configs["server"]["format_version"]
     # )

{mcserver_cli-4.2.0 → mcserver_cli-4.4.0}/src/mcserver/commands/import_setup.py

@@ -1,7 +1,7 @@
 from argparse import Namespace
 
 
-def main(args: Namespace) -> int:
+def run(args: Namespace) -> int:
     file: str = args.file
     import logging as log
 

mcserver_cli-4.2.0/src/mcserver/commands/init.py → mcserver_cli-4.4.0/src/mcserver/commands/initialize_server.py

@@ -1,7 +1,7 @@
 from argparse import Namespace
 
 
-def init(args: Namespace) -> int:
+def run(args: Namespace) -> int:
     from ..modrinth.shared import SearchSortIndex
 
     # CLI Arguments

{mcserver_cli-4.2.0 → mcserver_cli-4.4.0}/src/mcserver/commands/list_projects.py

@@ -1,7 +1,7 @@
 from argparse import Namespace
 
 
-def main(args: Namespace) -> int:
+def run(args: Namespace) -> int:
     import logging as log
 
     log.error("Command is not implemented yet.")

{mcserver_cli-4.2.0 → mcserver_cli-4.4.0}/src/mcserver/commands/op_grant.py

@@ -1,7 +1,7 @@
 from argparse import Namespace
 
 
-def main(args: Namespace) -> int:
+def run(args: Namespace) -> int:
     players: list[str] = args.players
     import logging as log
 

mcserver_cli-4.4.0/src/mcserver/commands/op_list.py

@@ -0,0 +1,35 @@
+import logging
+from argparse import Namespace
+
+from ..server_files import ops
+from ..shared import pluralize
+
+logger = logging.getLogger(__name__)
+
+
+def run(args: Namespace) -> int:
+    ops_file = ops.ops_file_path
+    if not ops_file.exists():
+        logger.error(f"Operator file '{ops.ops_file_path}' not found.")
+        return 1
+
+    operator_players = ops.list_players()
+
+    player_count = len(operator_players)
+    if player_count == 0:
+        logger.info("There's no operator player.")
+        return 0
+
+    player_list: list[str] = []
+    for player in operator_players:
+        player_list.append(
+            f"{player['player_name']} ({player['player_uuid']}) Level: {player['permission_level']}"
+        )
+
+    logger.info(
+        f"There {pluralize('is', player_count)} {player_count} {pluralize('operator', player_count)}:"
+    )
+
+    player_list.sort()
+    print("\n".join(player_list))
+    return 0

mcserver_cli-4.4.0/src/mcserver/commands/op_revoke.py

@@ -0,0 +1,43 @@
+import logging
+from argparse import Namespace
+from uuid import UUID
+
+from ..server_files import ops
+from ..shared import pluralize
+
+logger = logging.getLogger(__name__)
+
+
+def run(args: Namespace) -> int:
+    player_identifiers: list[str] = args.players
+
+    player_uuids: list[UUID] = []
+    player_names: list[str] = []
+    for player in player_identifiers:
+        if len(player) > 16:
+            logger.debug(f"{player} is probably an UUID")
+            player_uuids.append(UUID(player))
+        else:
+            logger.debug(f"{player} is probably a name")
+            player_names.append(player)
+
+    removed_players = ops.remove_players(player_uuids, player_names)
+
+    player_count: int = len(removed_players)
+    if player_count == 0:
+        logger.info("No matching player found.")
+        return 0
+
+    player_list: list[str] = []
+    for player in removed_players:
+        player_list.append(
+            f"{player['player_name']} ({player['player_uuid']}) Level: {player['permission_level']}"
+        )
+
+    logger.info(
+        f"There {pluralize('is', player_count)} {player_count} operator {pluralize('player', player_count)} that {pluralize('is', player_count)} removed:"
+    )
+
+    player_list.sort()
+    print("\n".join(player_list))
+    return 0

{mcserver_cli-4.2.0 → mcserver_cli-4.4.0}/src/mcserver/commands/print_help.py

@@ -1,7 +1,7 @@
 import argparse
 
 
-def main(args: argparse.Namespace) -> int:
+def run(args: argparse.Namespace) -> int:
     parser: argparse.ArgumentParser = args.parser
     parser.print_help()
     return 0

{mcserver_cli-4.2.0 → mcserver_cli-4.4.0}/src/mcserver/commands/remove_projects.py

@@ -1,7 +1,7 @@
 from argparse import Namespace
 
 
-def main(args: Namespace) -> int:
+def run(args: Namespace) -> int:
     import logging as log
 
     log.error("Command is not implemented yet.")