Add missing stuff

COPYING

@@ -1,4 +1,4 @@
-Copyright (c) 2001-2017
+Copyright (c) 2001-2024
 Contributors to the Freedoom project.  All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

README.md

@@ -1,6 +1,6 @@
 # Freedoom Attic
 
-Since starting in 2003, [Freedoom](https://freedoom.github.io) has changed a lot since its inception, and the Attic is proof of this, as it contains resources previously submitted to Freedoom, but have since been replaced or were _never_ used in the first place due to a number of wild reasons, such as being outdated, not up to snuff, not a vanilla map, only test levels, etc - despite this, the many people behind Freedoom are grateful for the work of others who have made content for the game, even if it is no longer used.
+Since starting in 2001, [Freedoom](https://freedoom.github.io) has changed a lot since its inception, and the Attic is proof of this, as it contains resources previously submitted to Freedoom, but have since been replaced or were _never_ used in the first place due to a number of wild reasons, such as being outdated, not up to snuff, not a vanilla map, only test levels, etc - despite this, the many people behind Freedoom are grateful for the work of others who have made content for the game, even if it is no longer used.
 
 Be aware that, unlike now, Freedoom was not always meant to be a vanilla-only set of IWADs, meaning that to play some of the WADs here, an advanced Doom source port, such as [QZDoom](https://doomwiki.org/wiki/QZDoom), [PrBoom](https://doomwiki.org/wiki/PrBoom), [Pooch](https://doomwiki.org/wiki/Pooch) or any other port that is [Boom-compatible](https://doomwiki.org/wiki/Category:Boom_compatible) may be needed.
 

docs/anonymous/freedoom-manual-en.adoc

@@ -0,0 +1,29 @@
+= Freedoom Manual
+// SPDX-License-Identifier: BSD-3-Clause
+:toc:
+:toc-title:
+
+image::../graphics/titlepic/titlepic.png[Freedoom Title Image,align="center",width=380,pdfwidth=50vw]
+
+Welcome to Freedoom, a complete game that is
+https://www.gnu.org/philosophy/free-sw.html[free]
+and https://opensource.org/osd/[open source software].
+Freedoom is made available under the <<licence,modified BSD license>>, meaning that
+anyone is free to share it, modify it and reuse parts of it.
+
+For more details, see the website at https://freedoom.github.io/.
+
+[[story]]
+== The story
+
+Join us at AGM's star colony, see the galaxy! Heh. What a joke. The job offer sounded good on paper, and you really did get to see the galaxy - but briefly. Once you landed in the fancy spaceport on the other shore, they took you straight to your quarters (a tiny cell) and began your job training (brutal genetic experimentation). "It's all in the contract" they said! It wasn't, not even in the fine print. But there's no courts of law in space, are there now?
+
+So you sat meekly in your cell, slowly losing track of time, and looking back at your life on Earth. Not that there was much to look back on. "What kind of soldier doesn't want to kill?" - you looked back at your officer saying, as he dishonorably discharged you from your short-lived army career. Well, this kind. And now word's going around your fellow inmates that you're being prepared into some kind of private AGM super-soldiers. Some of these poor saps are actually looking forward to this! But not you - so for weeks now you've been planning an escape.
+
+Which didn't go very well. The AGM guys charged you with mutiny and transferred you to an outpost to await "trial" - but before you've even had time to process your new situation, the outpost had... Some issues in operation. That's what the loudspeakers said at least, urging everyone to remain calm. But then they've stopped. And you heard screams coming from beyond the corridor. And then the screams all suddenly stopped, as if on command.
+
+Well then - no use sitting around and waiting for whatever's going on over there to happen to you! You bend the bars and walk out, grab a pistol some guard dropped in the panic, and feel a slight smirk coming onto your face.
+
+Escape attempt 2.0, here we come! Destination: Earth! 
+
+== Installing Freedoom

docs/anonymous/story-guidelines.txt

@@ -0,0 +1,70 @@
+Here's a minimal list of lore points necessary to establish certain important things.
+
+- The aliens are an evil, genocidal empire. They are technologically advanced (mostly in biotechnology,
+psychic powers and dimensional stuff), but they are culturally very backwards, with their society
+dominated by dark religions and brutality. This is most likely the best path of least resistance
+to explain why the "alien" levels look the way they do.
+
+- The aliens are basically irredeemably evil bastards. From the highest Pain Lord to the lowest Serpentipede,
+they are thoroughly soaked in the vileness of the empire. This is necessary to get rid of any moral objections to shooting them.
+
+- The aliens come not from planet Horizon, but from an entire Horizon star system (where the planets are named
+Horizon-1, Horizon-2, etc). This is a minor change that makes them feel more threatening and also allows for
+extending the plot indefinitely (f.eg. "Oh, their planet got blown up last time? Well that was Horizon-4,
+this time it's Horizon-5"). It also feels more logical for human astronomers to name a whole system "Horizon"
+(because it's on the "horizon") rather than just a single planet.
+
+- JoD's nature and status can be left ambiguous. What's important here is that a) it is important
+enough to the aliens that losing it halts the invasion of Earth (ending Phase 2's story), and
+b) it is never portrayed as a tyrant that rules the aliens through fear or mind control,
+because that would diminish the aliens' evil and introduce objections to shooting them.
+
+- AGM first found the aliens 10 years ago by digging up their ancient ruins (and then building
+their bases over them for ease of access). They hid this fact from the world and have since
+exploited the lower aliens for top-secret genetics and combat research (especially their super-soldier program).
+This is necessary to explain the look of Phase 1 E2 maps, and the timeframe is just right for them to
+a) develop their research b) popularize the teleport pads on Earth (see below) and
+c) get too confident when unsealing the Pain Lords (also see below).
+
+- AGM is a secondary antagonist who caused the alien invasion through their greed and stupidity.
+Specifically, they ignored all warnings when unsealing the four Pain Lords (who called in the invasion)
+because they got too confident at this point. They should stay as a secondary antagonist because having
+them as major antagonists would be kind of a stretch, considering all of the stuff the player actually
+fights is aliens and alien-controlled zombies.
+
+- Teleport pads are alien technology which AGM sold as their own, and remotely hijacking them is how
+the aliens invaded their colony and later Earth. This is necessary because a) aliens use the teleport pads too,
+and b) it reinforces the "AGM caused the invasion through their greed" bit.
+
+- AGM is hunting Karl because they don't want him to reveal the truth about their inhumane super-soldier
+program to the world (or worse, reveal the fact that they covered up their first contact with aliens and
+are to blame for the invasion). This is important to reinforce the whole "Karl is searching for freedom"
+subplot that was carried over from the original story.
+
+
+Below there's some extra lore points that may or may not have been mentioned anywhere, but are important for explaining plot holes.
+
+- Despite teleport pads being AGM's greatest source of income, they cannot fully control them.
+They brush this off as a technical flaw, but in reality they still do not fully understand how they work.
+Most of their teleporters are strictly linked to each other. Aliens on the other hand can do whatever
+they want with the teleporters, including make interstellar jumps (which AGM cannot do).
+This patches up the plot hole of "why doesn't Karl just teleport wherever he needs to".
+
+- The remote teleport hijacking is done with the large Technospiders' psychic powers. This explains
+why E3 ends specifically after Karl kills a large Technospider. Karl knew the Technospider was doing this
+because his modified alien DNA allowed him to sense its psychic energy.
+
+- Warp-travel spaceships exist but they are expensive, unreliable, limited in size and easy to shoot down.
+They are used by humans for interstellar travel only. This patches up the plot hole of "why doesn't Karl
+just fly wherever he needs to with a spaceship".
+
+
+Here's some extra lore points that were never mentioned and are not important but they're interesting and fit the other lore.
+
+- The reason aliens occasionally use the AGM infinity symbol (and sometimes even the letters too)
+is because they think it's some sort of holy symbol or ward, and this is their way of "stealing" it for their own uses.
+
+- In Phase 2, AGM is not fighting the aliens because they're secretly considering joining them to be on the winning side.
+
+- Tripods, small Technospiders and Combat Slugs were secretly created by the AGM for combat research.
+The aliens liked the idea and started making more of their own using stolen technology.