adams-toolkit

codigo-fonte GPL-3.0 · espelho oficial · commit b208bae5
README.md · 99 linhas · raw
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
# Adams Toolkit

Aplicação de Windows que junta num sítio só o que um jogador de FiveM precisa:
instalar launchers e dependências, ver e atualizar drivers, afinar desempenho e
latência, limpar processos de fundo, ver as especificações do PC e editar clips.

WPF / .NET 8 · Windows 10 e 11 · Português.

> **Staff de servidores e verificações de PC:** ler
> **[TRANSPARENCIA.md](TRANSPARENCIA.md)**. Diz exatamente o que a app faz, o que
> não faz, e a linha de código de cada operação privilegiada.

## Porque é que este código está público

A aplicação não está assinada com um certificado Authenticode. Em scanners e
screenshares aparece como "editor desconhecido" e já custou bans a jogadores que
não fizeram nada de errado. Não há forma de responder a isso com promessas — só
com o código à vista. Está aqui tudo o que é compilado no binário distribuído.

## Funcionalidades

| Secção | O que faz |
|---|---|
| **Painel** | Notícias, estado da comunidade, temperaturas e uso do sistema |
| **Instalar** | Steam, Rockstar, Epic, EA, Ubisoft, Battle.net, GOG, ferramentas de voz — sempre a partir dos **links oficiais** de cada fabricante |
| **Atualizações** | Drivers via Windows Update (WUA COM) e NVIDIA |
| **Otimizador** | Plano de energia, prioridades, tweaks de rede/latência, processos de fundo, serviços opcionais, efeitos visuais, resolução do timer |
| **FiveM Center** | Abrir o jogo e as pastas, cache, ReShade, Snap Tap, repetição de teclado |
| **PC Check** | Relatório das especificações da máquina (só leitura, fica local) |
| **Editor** | Cortar e juntar clips com ffmpeg (NVENC quando disponível) |
| **Desinstalador** | Remove programas e apps da Store pelos desinstaladores oficiais |

Tudo o que altera definições do Windows guarda o valor original em
`%AppData%\AdamsToolkit\` e tem botão para reverter. A maior parte dos tweaks dura
só a sessão de Windows — reiniciar o PC repõe tudo.

## Estrutura

```
AdamsToolkit.csproj        projeto (net8.0-windows, WPF)
App.xaml                   tema (paleta, estilos, animações)
MainWindow.xaml(.cs)       shell: titlebar, sidebar, gate de login
Core/                      toda a lógica (ver TRANSPARENCIA.md para o mapa)
Views/                     um ficheiro por separador da app
bootstrap/                 instalador pequeno que trata do .NET em falta
deploy.sh                  script real de publicação
remote-config.sample.json  exemplo da configuração remota
```

## Compilar

```bash
dotnet publish -c Release -r win-x64 --self-contained false /p:PublishSingleFile=false
```

Requisito na máquina do jogador: .NET 8 Desktop Runtime (o `bootstrap/` instala-o
se faltar).

## Configuração remota

A administração faz-se editando **um único JSON alojado por quem corre a app**:
lista de aplicações e links, notícias, estado da comunidade, URL do backend de
acesso. Modelo completo em `remote-config.sample.json`.

A URL vem de `Core/RemoteConfig.cs` → `DefaultConfigUrl`, ou de
`%AppData%\AdamsToolkit\config-url.txt` (sem recompilar).

## Acesso

O acesso é dado por presença num servidor de Discord, através de um código de
emparelhamento de 6 caracteres. **Não usa OAuth** — a app não fica ligada à conta
do jogador nem aparece em "Aplicações autorizadas".

O backend que valida os códigos é um serviço à parte e **não faz parte deste
repositório**: aqui está só o cliente (`Core/DiscordAuth.cs`), que fala com quatro
endpoints (`/toolkit/start`, `/poll`, `/validate`, `/ping`). Quem quiser correr um
fork tem de pôr o seu próprio backend, ou apontar `AuthApiBase` para outro sítio.

Dados que saem do PC: ID de Discord, nome e avatar. Mais nada — ver
[TRANSPARENCIA.md](TRANSPARENCIA.md#o-que-sai-do-pc-para-a-internet).

## Dados locais

`%AppData%\AdamsToolkit\` — cache da configuração, sessão, backups dos valores
originais dos tweaks, histórico de downloads e a pasta `Downloads\`.

## Licença

[GPL-3.0](LICENSE). Podes usar, estudar, alterar e distribuir — **desde que o
resultado continue com a mesma licença e com o código aberto**. Se fizeres um fork,
ele fica público como este.

O nome **"Adams Toolkit"** e os ficheiros de marca em `Assets/` (logo e ícone) não
são abrangidos pela licença: um fork tem de usar nome e imagem próprios. Ver
[TRADEMARK.md](TRADEMARK.md).

## Segurança

[SECURITY.md](SECURITY.md).