![[OPENSOURCE] Patcher v2 by Hanashi](https://www.elitepvpers.com/forum/iconimages/metin2-pserver-guides-strategies/opensource-patcher-v2-hanashi_ltr.gif){kind=small}
Hallo Leute,
ich habe in letzter Zeit, über einen längeren Zeitraum, eine neue Version meines Patchers programmiert. Dieser Patcher läuft um einiges performanter als meine alte Version und bringt auch einige neue Features mit sich. Mehr dazu weiter unten.
Gliederung
- Features
- Voraussetzungen
- Download der Dateien
- Installation des Patchservers/der Weboberfläche
- Kompilieren des Patchers
- Benutzung der Weboberfläche
- Bilder
- Lizenz
- Nachwort
- Changelog
1. Features
nach oben
- performanter als der alte Patcher
- Downloadstatus in der Taskbar
- Funktion zum Automatischen Updaten des Patchers
- komplett Opensource
- Außerdem neu:
- Weboberfläche zur Konfiguration des Patchers
- verwalte deine Dateien direkt in der Weboberfläche
- lösche Dateien, lade neue Dateien hoch
- generiere die Patchliste
- lade die neue Patcherversion hoch
- Usermanagement zur Verwaltung der Weboberfläche
- Weboberfläche zur Konfiguration des Patchers
2. Voraussetzungen
nach oben
- Visual Studio 2010 oder höher
- einen Webserver mit Apache2 und PHP5 (dazu xml-, sqlite- und zip-Erweiterung für PHP5)
3. Download der Dateien
nach oben
- Klicke
um zu meiner GitHub-Repository zu gelangen. - Lade die Dateien über den Button
herunter. Du kannst auch ein Git-Clone machen, das werde ich aber hier nicht erklären.
- Nun wird eine Zip-Datei heruntergeladen.
- Diese Datei musst du nun entpacken und machst mit Punkt 4 weiter.
4. Installation des Patchservers/der Weboberfläche
nach oben
- Lade die Dateien aus dem Ordner Patchserver auf deinen Webserver hoch.
- Überprüfe ob folgende Ordner 777-Rechte haben
- client/
- filelist/
- update/
- admin/cache/
- admin/cnf/
- admin/cnf/db/
- admin/tmp/
- Rufe nun die Datei admin/install.php in deinem Browser auf.
- Klicke auf den Button mit der Aufschrift "Install".
- Wenn die Installation erfolgreich war wird dies angezeigt. Lösche nun die Dateien install.php und tmpl/install.tpl.
- Nun kannst du dich in dem Pfad admin/ mit den Benutzernamen admin und dem Passwort admin123 einloggen.
5. Kompilieren des Patchers
nach oben
- Gehe in den Ordner Patcher und öffne die Datei Patcher.sln mit Visual Studio.
- Bearbeite die Datei Config.cs. Hier eine Erklärung der Variablen, auch wenn sie selbsterklärend sind:
- HomepageURL gibt den Pfad zur Webseite deines Servers an.
- ConfigurationEXE gibt den Namen der standardmäßig benannten config.exe an.
- PatchserverURL gibt die URL zum Patchserver an.
- BinaryName gibt den Namen der .bin Datei an.
- Drücke nun Strg+Shift+B um die komplette Projektmappe zu kompilieren.
- Als nächstes solltest du die Weboberfläche benutzen und den aktuellen Patcher hochladen.
6. Benutzung der Weboberfläche
nach oben
6.1. Dateien verwalten
nach oben
- Melde dich an der Weboberfläche an.
- Solltest du nicht bei der Dateiverwaltung gelandet sein, nagiere im Menü zur Dateiverwaltung.
- Hier kannst du nun mit einen Klick auf Löschen hochgeladene Dateien vom Server löschen.
- Wenn du neue Dateien hochladen möchtest, musst du folgendes beachten.
- Es können nur Zip-Dateien hochgeladen werden.
- Die Zip-Dateien müssen einen Ordner namens client beinhalten. In diesem Ordner müssen die client-Dateien hierarchisch liegen, wie sie im Clientordner liegen.
6.2. Clientseitiges löschen
nach oben
- Gehe zur Weboberfläche und Klicke auf Clientseitg löschen.
- Gebe nun einen Dateinamen ein und klicke auf Hinzufügen.
- Beim Nächsten Start des Patchers, werden die Dateien Clientseitig gelöscht.
6.3. Patchliste generieren/bearbeiten
nach oben
- Gehe zur Weboberfläche und Klicke auf Patchliste.
- Hier kannst du nun nach Veränderung der Dateien, die Patchliste neu generieren oder manuell bearbeiten.
6.4. neue Patcherversion hochladen
nach oben
- Gehe zur Weboberfläche und Klicke auf Patcherversion.
- Gib nun die neue Versionsnummer ein und klicke auf Hochladen um die neue Version auszuwählen.
- Die Version wird nun hochgeladen.
- Nach erfolgreichen Upload, wird beim Start des Patchers die neue Version heruntergeladen.
- Achtung: vergiss nicht die kompilierte Updater.exe in den Ordner update auf den Server hochzuladen.
7. Bilder
nach oben
8. Lizenz
nach oben
Der Code des Patchers und der Weboberfläche darf ohne Nachfrage verändert und benutzt werden. Es ist nicht erlaubt Teile des Codes oder den ganzen Code zu verkaufen, außerdem ist es nicht erlaubt ohne Genehmigung einen Service zum Verkauf von Patchern mit diesen Code zu starten. Der Code ist weiterhin geistiges Eigentum von Hanashi.
9. Nachwort
nach oben
Der Patcher ist frei anpassbar, deswegen wurde von meiner Seite her keine große Mühe für ein ordentliches Design vorgenommen. Die derzeitige Oberfläche dient nur als Beispiel und darf natürlich verändert werden. Wer die Oberfläche kritisiert, sollte auch eine bessere zum Anschauen liefern
Da ich sehr neugierig bin, wie ihr eure Patcher gestaltet, freue ich mich über Screenshots eurer Patcher.
Bitte vergesst nicht, dass die beiden DLLs, die im Debug- oder Release-Ordner liegen notwendig sind um den Patcher unter Windows 7 oder höher zu starten, insofern ihr die Funktionalität für den Status in der Taskbar nicht entfernt.
Ich wünsche euch viel Spaß mit dem Patcher. Dies wird natürlich nicht mein letzter sein und ich freue mich über Anregungen für neue Ideen.
Wenn ihr Fehler findet, bitte hier Posten:
LG Hanashi
10. Changelog
nach oben
13. März 2013
- Manifest Bug gefixed
- Readme editiert
- .gitignore erweitert
- Fehlerausgabe bei Installation eingefügt
- Code verkürzt
- mhash-Funktion mit in PHP integrierte hash-Funktion ersetzt
![[SA]BlooD's Avatar](https://www.elitepvpers.com/forum/customavatars/avatar4526365_4.gif){kind=avatar}
![[Cyberos]'s Avatar](https://www.elitepvpers.com/forum/customavatars/avatar790949_15.gif){kind=avatar}
