mirror of
https://github.com/mleem97/gregWiki.git
synced 2026-04-11 03:29:19 +02:00
55 lines
2.2 KiB
Markdown
55 lines
2.2 KiB
Markdown
---
|
|
title: Erste Schritte
|
|
sidebar_label: Erste Schritte
|
|
description: "Split-Repo-Workspace: gregFramework-Layout, Core bauen und wo die Doku liegt."
|
|
---
|
|
|
|
Die Struktur ist **Multi-Repo** mit `gregFramework/` als lokalem Wrapper-Ordner. Darin liegen die eigenständigen Repositories, z. B.:
|
|
|
|
- `gregCore/` — **Framework-Kern**: Übersetzung, Hooks, Harmony-/Event-Laufzeit, Templates, Bridges und übrige Kernfunktionen
|
|
- `gregMod.<Name>/` (einzelne Mod-Repos, direkt unter `gregFramework/`)
|
|
- `gregExt.<Name>/` (einzelne Extension-Repos, direkt unter `gregFramework/`)
|
|
- `gregWiki/` (Dokumentation)
|
|
- `gregStore/` (**Gregweb**, privates Repository — Modstore Web + Infra; Next.js unter `web/`)
|
|
|
|
Das Upstream-Projekt **DataCenter-RustBridge** wird in den Core integriert und liegt unter:
|
|
|
|
- `gregCore/bridges/gregSta.RustBridge/`
|
|
|
|
## Core bauen
|
|
|
|
```text
|
|
dotnet build gregCore/FrikaMF.sln -c Release
|
|
```
|
|
|
|
Alternativ in der IDE: `gregCore/FrikaMF.sln` öffnen.
|
|
|
|
## Sprache (Mods / Plugins / Extensions)
|
|
|
|
**Pflicht:** Gameplay- und Integrationslogik für Mods, MelonLoader-Plugins und Extensions ausschließlich in **C#**. Siehe [Modding-Sprache (nur C#)](/wiki/reference/modding-language-requirement).
|
|
|
|
## Hook-Naming
|
|
|
|
- **Zielkonvention:** `FMF.<DOMAIN>.<Event>` (siehe [`CONTRIBUTING.md`](https://github.com/mleem97/gregFramework/blob/master/CONTRIBUTING.md)).
|
|
- **Registry:** [`FrikaModFramework/fmf_hooks.json`](https://github.com/mleem97/gregFramework/blob/master/FrikaModFramework/fmf_hooks.json).
|
|
- **Legacy-Runtime-Strings** können noch `FFM.*` in [`HookNames`](https://github.com/mleem97/gregFramework/blob/master/framework/FrikaMF/HookNames.cs) nutzen, bis migriert.
|
|
|
|
## Mod starten
|
|
|
|
1. Neues Mod-Repo als Ordner `gregMod.<Name>/` unter `gregFramework/` anlegen.
|
|
2. Templates aus `gregCore/Templates/` nutzen.
|
|
3. Hook-Metadaten pflegen und Mod im eigenen Repo versionieren.
|
|
|
|
## Dokumentations-Site
|
|
|
|
- **Repo:** `gregWiki/`
|
|
- **Inhalt:** Markdown/MDX in diesem Repo, angepasst an den Split-Stand.
|
|
|
|
### Docker
|
|
|
|
Im `gregWiki`-Root: `docker build -t gregwiki-docs .` und `docker run --rm -p 3000:3000 gregwiki-docs`.
|
|
|
|
### MCP
|
|
|
|
Siehe [`reference/mcp-server`](/wiki/reference/mcp-server) im Core (`gregCore/mcp-server/`).
|