PyPlanet

包含三大核心功能：Hello World模板供新手学习插件结构、快速启新项目；GitHub安装器通过命令行一键安装、更新、管理GitHub上的PyPlanet插件；Clan Spirits插件用于clan竞技计分，支持成员管理、 standings查看、数据导出等。适用于PyPlanet插件开发、插件管理及clan赛事场景，输入为PyPlanet指令，输出对应功能反馈，需依赖PyPlanet≥0.11、Python3.8+

tomekdot

热度 14.15

最近更新 2026-08-15 02:41:36

分类：开发依赖：纯提示词应用场景：代码生成 / 自动化脚本 / 模板 / 数据处理 ...

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add pyplanet

Metadata

name: pyplanet
description: PyPlanet plugin development, GitHub installer, and Clan Spirits plugin
version: 2.0.0
metadata: {"hermes":{"tags":["pyplanet","maniaplanet","plugin","github","installer","clan-spirits","scoring","template"]}}

🎮 PyPlanet Skills

Complete PyPlanet plugin ecosystem: starter template, GitHub installer, and Clan Wars plugin.

📋 Contents

Hello World — starter template
GitHub Installer — install plugins from GitHub
Clan Spirits — competitive clan scoring

🚀 Hello World

Minimal starter template for PyPlanet plugins.

When to Use

Learning PyPlanet plugin structure
Starting a new plugin
Understanding AppConfig basics

Quick Start

Option 1: Install via GitHub Installer

/ghinstall tomekdot/pyplanet-hello-world

Option 2: Manual Install

Download from https://github.com/tomekdot/pyplanet-hello-world
Place hello_world/ in apps/
Add 'apps.hello_world' to APPS['default'] in settings/apps.py
Restart PyPlanet

Template Code

from pyplanet.apps.config import AppConfig

class MyPlugin(AppConfig):
    name = 'my_plugin'

    async def on_start(self):
        await super().on_start()
        await self.instance.chat('✅ My plugin started!')

    async def on_stop(self):
        await super().on_stop()
        await self.instance.chat('🛑 My plugin stopped!')

📦 GitHub Installer

Install PyPlanet plugins directly from GitHub with one command.

When to Use

Installing plugins without manual downloads
Managing multiple plugins
Updating plugins easily

Commands

Command	Description
`/ghinstall <user>/<repo>`	Install from GitHub (tries `main` then `master`)
`/ghinstall <url.zip>`	Install from direct zip URL
`/ghlist`	List all GitHub-installed plugins
`/ghremove <name>`	Remove a plugin
`/ghupdate <name>`	Update a plugin

Installation

Create apps/github_installer/__init__.py:

from .app import GitHubInstaller

Create apps/github_installer/app.py (source: github_installer/app.py)
Register in settings/apps.py:

'apps.github_installer',

Restart PyPlanet

🏆 Clan Spirits

Competitive clan/team scoring based on local record positions.

When to Use

Setting up clan competitions
Tracking clan points
Managing clan members

Commands

Command	Description
`/joinclan <name>`	Join (or create) a clan
`/leaveclan`	Leave current clan
`/myclan`	Show your clan + total points
`/clans`	Show clan standings
`/clanswin`	Open standings window
`/clanmembers [name]`	List members of a clan
`/clanwexport [format]`	Export standings (csv/json)
`/clanw_reset confirm=yes`	Reset all scoring data (admin)
`/clanw_recalc`	Recalculate points (admin)

Installation

Option 1: GitHub Installer (recommended)

/ghinstall tomekdot/pyplanet-clanspirits

Option 2: Manual Install

Clone from https://github.com/tomekdot/pyplanet-clanspirits
Place clanwars/ in apps/
Add 'apps.clanwars' to APPS['default']
Restart PyPlanet

Data Model

Clan(id, name)
PlayerClan(player_id, clan_id)
PlayerClanMapScore(map_id, player_id, clan_id, points)
ClanAggregateScore(clan_id, points)

🚨 Requirements

PyPlanet >= 0.11
Python 3.8+
local_records app (for Clan Wars)

📚 Sources

Hello World: https://github.com/tomekdot/pyplanet-hello-world
GitHub Installer: https://github.com/tomekdot/pyplanet-github-installer
Clan Spirits: https://github.com/tomekdot/pyplanet-clanspirits

📄 See references/original-skills.md for original skill metadata and source details.

📝 License

MIT