mumo - GitLite

KO | EN

gitlite — search

#javascript #react #typescript #android #rust #nodejs #java #awesome #vue #awesome-list #ios #mcp #openai #open-source

mumo

(★ 62)

Mumble Moderator framework simplifying development of plugins that connect to Mumble servers via Ice. (handles basic ICE connectivity, contains basic module loading and message multiplexing)

파일 탐색기

최종 버전 다운로드 (.zip)

- - docker-image_build.yml
  - docker-image_publish.yml
  - python.yml
- settings.json
- setup-ubuntu.md
- third-party-modules.md
- - __init__.py
  - db.py
  - db_test.py
  - README.md
  - source.py
  - source_test.py
  - users.py
  - users_test.py
- __init__.py
- bf2.py
- idlemove.py
- onjoin.py
- samplecontext.py
- seen.py
- test.py
- bf2.ini
- idlemove.ini
- onjoin.ini
- samplecontext.ini
- seen.ini
- source.ini
- test.ini
- __init__.py
- mbf2man.py
.gitignore
config.py
config_test.py
docker.md
Dockerfile
entrypoint.sh
init-script
mumo.ini
mumo.py
mumo_manager.py
mumo_manager_test.py
mumo_module.py
README.md
testsuite.py
worker.py
worker_test.py

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# mumo - The Mumble Moderator

Mumo is meant to provide a platform on which Python-based Mumble server ICE extension modules can be built upon. The goal is to reduce the boilerplate needed
to interact with the Mumble server to a minimum.

To achieve this goal, tasks like Ice interface setup, basic error
handling, configuration management, logging, and more are provided
by mumo. Developers can focus on their specific functionality instead.

## Requirements

mumo requires:

* python >=3.2
* python3-zeroc-ice
* zeroc-ice-slice
* mumble-server >=1.2.3 (not tested with lower versions)

## Setting up

To configure and run mumo take a look at the `mumo.ini` and the module
specific configurations in `modules-available` folder. Enabling modules
is done by linking the configuration in modules-available to the
`modules-enabled` folder.

## Docker image

An official docker image is available at https://hub.docker.com/r/mumblevoip/mumo.

More information in [docker.md](docker.md).

## Modules for Mumble moderator

### Included modules

Currently, mumo comes with the following modules:

#### bf2

Battlefield 2 game management plugin that can dynamically move players into appropriate channels and groups to fit the in-game command structure. This is achieved by using data gathered from Mumble's positional audio system and does not require cooperation from the game server.

#### idlemove

Plugin for moving players that have been idle for a configurable amount of time into an idle channel. Optionally the players can be muted/deafened on move.

#### onjoin

Moves players into a specific channel on connect regardless of which channel they were in when they left last time.

#### seen

Makes the server listen for a configurable keyword to ask for the last time a specific nick was seen on the server.

#### source

Source game management plugin that can dynamically move players into on-the-fly-created channel structures representing in-game team setup.
This is achieved by using data gathered from Mumble's positional audio system and does not require cooperation from the game server.
 
Currently, the following source-engine-based games are supported: Team Fortress 2, Day of Defeat: Source, Counter-Strike: Source, Half-Life 2: Deathmatch.

#### test

A debugging plugin that registers for all possible events and outputs every call with parameters into the debug log.

### 3rd party modules
See [docs/third-party-modules.md](docs/third-party-modules.md)

## Contributing
We appreciate contributions. For example as issue or suggestion reports and comments, change pull requests, additional modules, or extending documentation.

You can talk to us in tickets or in chat in [#mumble-dev:matrix.org](https://matrix.to/#/#mumble-dev:matrix.org).