Haloman363/rune-claude

O que rune-claude faz?

Plugin para Claude Code com tema de RuneScape, incluindo XP, missões, economia e sons

Visão Geral

Este plugin adiciona uma camada de gamificação ao Claude Code, inspirada no clássico MMORPG RuneScape. Ao usar comandos no terminal ou interagir com o agente Claude, você ganha pontos de experiência (XP), sobe de nível, completa missões e acumula moedas virtuais. Tudo é salvo localmente, e o progresso persiste entre sessões.

Funcionalidades

• Sistema de XP e Níveis: Ganhe XP ao executar ações produtivas; suba de nível para desbloquear vantagens.
• Missões (Quests): Missões automáticas são geradas com base no seu uso do Claude Code. Complete-as para recompensas.
• Economia Virtual: Acumule moedas (gp) para comprar itens ou upgrades.
• Efeitos Sonoros: Sons temáticos de RuneScape tocam ao subir de nível, completar missões ou ganhar moedas.
• Persistência: O progresso é salvo em um arquivo JSON no diretório de configuração do Claude Code.

Instalação

Adicione o seguinte ao seu arquivo claude.json ou siga as instruções do Claude Code para instalar plugins:

{
  "plugins": [
    {
      "name": "rune-claude",
      "source": "Haloman363/rune-claude"
    }
  ]
}

Certifique-se de que o Node.js está instalado (versão 18+). O plugin será baixado e instalado automaticamente na próxima inicialização do Claude Code.

Uso

Após a instalação, o plugin é ativado automaticamente. Você pode interagir com ele usando os seguintes comandos dentro do Claude Code:

• /xp – Exibe seu nível atual, XP total e progresso para o próximo nível.
• /quests – Lista missões disponíveis e seu progresso.
• /balance – Mostra seu saldo de moedas (gp).
• /shop – Abre a loja virtual (itens e upgrades).
• /sound on|off – Ativa ou desativa os efeitos sonoros.
• /reset – Reseta todo o progresso (cuidado: irreversível).

Exemplo de Interação

> /xp
🔮 Nível 7 | XP: 1.240 / 1.600
💰 Moedas: 340 gp

Configuração

As configurações do plugin são gerenciadas pelo arquivo de configuração do Claude Code (~/.claude/plugins/rune-claude/config.json). É possível ajustar:

• xpmultiplier: Multiplicador de XP (padrão: 1.0)
• coindrop: Quantidade de moedas ganhas por ação (padrão: 10)
• soundEnabled: Habilita ou desabilita sons (padrão: true)
• questInterval: Intervalo médio (em ações) para geração de novas missões (padrão: 20)

Dependências

• Node.js 18+
• Claude Code (versão mais recente)
• Sistema operacional: macOS, Linux ou Windows (com terminal compatível)

Contribuição

Contribuições são bem-vindas! Siga os passos:

1. Fork o repositório
2. Crie um branch para sua funcionalidade (git checkout -b feature/nova-funcionalidade)
3. Commit suas alterações (git commit -m 'Adiciona nova funcionalidade')
4. Push para o branch (git push origin feature/nova-funcionalidade)
5. Abra um Pull Request

Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

Aviso Legal

RuneScape é uma marca registrada da Jagex Ltd. Este plugin é um projeto de fã não oficial e não tem afiliação com a Jagex.