mirror of
https://github.com/ArchipelagoMW/Archipelago.git
synced 2026-03-26 11:53:23 -07:00
e0cbf77dae
* APQuest * Add confetti cannon * ID change on enemy drop * nevermind * Write the apworld * Actually implement hard mode * split everything into multiple files * Push out webworld into a file * Comment * Enemy health graphics * more ruff rules * graphics :) * heal player when receiving health upgrade * the dumbest client of all time * Fix typo * You can kinda play it now! Now we just need to render the game... :))) * fix kvui imports again * It's playable. Kind of * oops * Sounds and stuff * exceptions for audio * player sprite stuff * Not attack without sword * Make sure it plays correctly * Collect behavior * ruff * don't need to clear checked_locations, but do need to still clear finished_game * Connect calls disconnect, so this is not necessary * more seemless reconnection * Ok now I think it's correct * Bgm * Bgm * minor adjustment * More refactoring of graphics and sound * add graphics * Item column * Fix enemies not regaining their health * oops * oops * oops * 6 health final boss on hard mode * boss_6.png * Display APQuest items correctly * auto switch tabs * some mypy stuff * Intro song * Confetti Cannon * a bit more confetti work * launcher component * Graphics change * graphics and cleanup * fix apworld * comment out horse and cat for now * add docs * copypasta * ruff made my comment look unhinged * Move that comment * Fix typing and don't import kvui in nogui * lmao that already exists I don't need to do it myself * Must've just copied this from somewhere * order change * Add unit tests * Notes about the client * oops * another intro song case * Write WebWorld and setup guides * Yes description provided * thing * how to play * Music and Volume * Add cat and horse player sprites * updates * Add hammer and breakable wall * TODO * replace wav with ogg * Codeowners and readme * finish unit tests * lint * Todid * Update worlds/apquest/client/ap_quest_client.py Co-authored-by: Duck <31627079+duckboycool@users.noreply.github.com> * Update worlds/apquest/client/custom_views.py Co-authored-by: Duck <31627079+duckboycool@users.noreply.github.com> * Filler pattern * __future__ annotations * twebhost * Allow wasd and arrow keys * correct wording * oops * just say the website * append instead of += * qwint is onto my favoritism * kitty alias * Add a comment about preplaced items for assertAccessDependency * Use classvar_matrix instead of MultiworldTestBase * actually remove multiworld stuff from those tests * missed one more * Refactor a bit more * Fix getting of the user path * Actually explain components * Meh * Be a bit clearer about what's what * oops * More comments in the regions.py file * Nevermind * clarify regions further * I use too many brackets * Ok I'm done fr * simplify wording * missing . * Add precollected example * add note about precollected advancements * missing s * APQuest sound rework * Volume slider * I forgot I made this * a * fix volume of jingles * Add math trap to game (only works in play_in_console mode so far) * Math trap in apworld and client side * Fix background during math trap * fix leading 0 * Sound and further ui improvements for Math Trap * fix music bug * rename apquest subfolder to game * Move comment to where it belongs * Clear up language around components (hopefully) * Clear up what CommonClient is * Reword some more * Mention Archipelago (the program) explicitly * Update worlds/apquest/docs/en_APQuest.md Co-authored-by: Ixrec <ericrhitchcock@gmail.com> * Explain a bit more why you would use classvar matrix * reword the assert raises stuff * the volume slider thing is no longer true * german game page * Be more clear about why we're overriding Item and Location * default item classification * logically considered -> relevant to logic () * Update worlds/apquest/items.py Co-authored-by: Ixrec <ericrhitchcock@gmail.com> * a word on the ambiguity of the word 'filler' * more rewording * amount -> number * stress the necessity of appending to the multiworld itempool * Update worlds/apquest/locations.py Co-authored-by: Ixrec <ericrhitchcock@gmail.com> * get_location_names_with_ids * slight rewording of the new helper method * add some words about creating known location+item pairs * Add some more words to worlds/apqeust/options.py * more words in options.py * 120 chars (thanks Ixrec >:((( LOL) * Less confusing wording about rules, hopefully? * victory -> completion * remove the immediate creation of the hammer rule on the option region entrance * access rule performance * Make all imports module-level in world.py * formatting * get rid of noqa RUF012 (and also disable the rule in my local ruff.toml * move comment for docstring closer to docstring in another place * advancement???? * Missing function type annotations * pass mypy again (I don't love this one but all the alternatives are equally bad) * subclass instead of override * I forgor to remove these * Get rid of classvar_matrix and instead talk about some other stuff * protect people a bit from the assertAccessDependency nonsense * reword a bit more * word * More accessdependency text * More accessdependency text * More accessdependency text * More accessdependency text * oops * this is supposed to be absolute * Add some links to docs * that's called game now * Add an archipelago.json and explain what it means * new line who dis * reorganize a bit * ignore instead of skip * Update archipelago.json * She new on my line till I * Update archipelago.json * add controls tab * new ruff rule? idk * WHOOPS * Pack graphics into fewer files * annoying ruff format thing * Cleanup + mypy * relative import * Update worlds/apquest/client/custom_views.py Co-authored-by: Fabian Dill <Berserker66@users.noreply.github.com> * Update generate_math_problem.py * Update worlds/apquest/game/player.py Co-authored-by: Fabian Dill <Berserker66@users.noreply.github.com> --------- Co-authored-by: Duck <31627079+duckboycool@users.noreply.github.com> Co-authored-by: Ixrec <ericrhitchcock@gmail.com> Co-authored-by: Fabian Dill <Berserker66@users.noreply.github.com>
79 lines
4.3 KiB
Markdown
79 lines
4.3 KiB
Markdown
# APQuest
|
|
|
|
## Wo ist die Seite für die Einstellungen?
|
|
|
|
Die [Seite für die Spielereinstellungen dieses Spiels](../player-options) enthält alle Optionen die man benötigt, um
|
|
eine YAML-Datei zu konfigurieren und zu exportieren.
|
|
|
|
## Was ist APQuest?
|
|
|
|
APQuest ist ein Spiel, welches von NewSoupVi für Archipelago entwickelt wurde.
|
|
Es ist ein minimalistisches 8bit-inspiriertes Abenteuerspiel mit gitterförmiger Bewegungssteuerung.
|
|
APQuest ist ungefähr 20 Sekunden lang. Der Client kann aber nahtlos zwischen mehreren APQuest-Slots wechseln.
|
|
Wenn du 10 APQuest-Slots in einer Multiworld haben willst, sollte das also problemlos möglich sein.if you want to have 10 of them, that should work pretty well.
|
|
|
|
Ausschlaggebend ist bei APQuest, dass das gesamte Spiel in der .apworld enthalten ist.
|
|
Wenn du also die .apworld in deine
|
|
[Archipelago-Installation](https://github.com/ArchipelagoMW/Archipelago/releases/latest) installiert hast,
|
|
kannst du APQuest spielen.
|
|
|
|
## Warum existiert APQuest?
|
|
|
|
APQuest ist als Beispiel-.apworld geschrieben, mit welchem neue .apworld-Entwickler lernen können, wie man eine
|
|
.apworld schreibt.
|
|
Der [APQuest-Quellcode](https://github.com/NewSoupVi/Archipelago/tree/apquest/worlds/apquest) enthält unzählige Kommentare und Beispiele, die erklären,
|
|
wie jeder Teil der World-API funktioniert.
|
|
Dabei nutzt er nur die modernsten API-Funktionen (Stand: 2025-08-24).
|
|
|
|
Das sekundäre Ziel von APQuest ist, eine semi-minimale, generische .apworld zu sein, die Archipelago selbst gehört.
|
|
Damit kann sie für Archipelagos Unit-Tests benutzt werden,
|
|
ohne dass sich die Archipelago-Entwickler davor fürchten müssen, dass APQuest irgendwann gelöscht wird.
|
|
|
|
Das dritte Ziel von APQuest ist, das erste "Spiel in einer .apworld" zu sein,
|
|
wobei das ganze Spiel in Python und Kivy programmiert ist
|
|
und innerhalb seines CommonClient-basierten Clients spielbar ist.
|
|
Ich bin mir nicht ganz sicher, dass es wirklich das erste Spiel dieser Art ist, aber ich kenne bis jetzt keine anderen.
|
|
|
|
## Wenn ich mich im APQuest-Client angemeldet habe, wie spiele ich dann das Spiel?
|
|
|
|
WASD oder Pfeiltasten zum Bewegen.
|
|
Leertaste, um dein Schwert zu schwingen (wenn du es hast) und um mit Objekten zu interagieren.
|
|
C, um die Konfettikanone zu feuern.
|
|
|
|
Öffne Kisten, zerhacke Büsche, öffne Türen, aktiviere Knöpfe, besiege Gegner.
|
|
Sobald du den Drachen im oberen rechten Raum bezwingst, gewinnst du das Spiel.
|
|
Das ist alles! Viel Spaß!
|
|
|
|
## Ein Statement zum Besitz von APQuest
|
|
|
|
APQuest ist mit der [MIT-Lizenz](https://opensource.org/license/mit) lizenziert,
|
|
was heißt, dass es von jedem für jeden Zweck modifiziert und verbreitet werden kann.
|
|
Archipelago hat jedoch seine eigenen Besitztumsstrukturen, die über der MIT-Lizenz stehen.
|
|
Diese Strukturen machen es unklar,
|
|
ob eine .apworld-Implementierung überhaupt permanent verlässlich in Archipelago bleibt.
|
|
|
|
Im Zusammenhang mit diesen unverbindlichen, nicht gesetzlich verpflichtenden Besitztumsstrukturen
|
|
mache ich die folgende Aussage.
|
|
|
|
Ich, NewSoupVi, verzichte hiermit auf alle Rechte, APQuest aus Archipelago zu entfernen.
|
|
Dies bezieht sich auf alle Teile von APQuest mit der Ausnahme der Musik und der Soundeffekte.
|
|
Wenn ich die Töne entfernt haben möchte, muss ich dafür selbst einen PR öffnen.
|
|
Dieser PR darf nur die Töne entfernen und muss APQuest intakt und spielbar halten.
|
|
|
|
Solang ich der Maintainer von APQuest bin, möchte ich als solcher agieren.
|
|
Das heißt, dass jegliche Änderungen an APQuest zuerst von mir genehmigt werden müssen.
|
|
|
|
Wenn ich jedoch aufhöre, der Maintainer von APQuest zu sein,
|
|
egal ob es mein eigener Wunsch war oder ich meinen Maintainer-Verantwortungen nicht mehr nachkomme,
|
|
dann wird APQuest automatisch Eigentum der Core-Maintainer von Archipelago,
|
|
die dann frei entscheiden können, was mit APQuest passieren soll.
|
|
Es wäre mein Wunsch, dass wenn APQuest an eine andere Einzelperson übergeben wird,
|
|
diese Person sich an ähnliche Eigentumsregelungen hält wie ich.
|
|
|
|
Hoffentlich stellt dieses Statement sicher, dass APQuest für immer eine .apworld sein kann,
|
|
auf die Archipelago sich verlassen kann.
|
|
Wenn die Besitztumsstrukturen von Archipelago geändert werden,
|
|
vertraue ich den Core-Maintainern (bzw. den Eigentümern von Archipelago generell) damit,
|
|
angemessene Entscheidungen darüber zu treffen,
|
|
wie dieses Statement im Kontext der neuen Regeln interpretiert werden sollte.
|