PrBOOMplus-ENHANCED

Table of contents

-Context

What is PrBoom-Plus-Enhanced

PrBoom+ Enhanced or PrBoom-Plus-Enhanced also name PB+E is a free copyleft software in development for the FPS game Doom (PrBoom-Plus-Enhanced Launcher, and the versions for an operating system... are affiliated to the same idea). So this is a port is in development since -11/26/2023 15H46.55... (UTC+2) [^But Damnerz got the idea before.] PrBoom-Plus-Enhanced has to be enhanced version of the existing ports PrBoom-Plus with the new features from others ports : DSDA Doom (Doom Speed Demo Archive is a website and a Doom source port), MBF (stand for Marines Best Friend), PrBoom and maybe others ports (idk like GzDoom or Crispy Doom or Eternity Engine). This project will work on a bunch devices like the Nintendo 3DS and Linux distros and Windows OS, PrBoom-Plus-Enhanced 3DS takes some features from some DsDoom, PrBoom 3ds, and chocolate DOOM DS/3DS, maybe some other existing ports available on the web.

-Purpose of the project

So the goals of the project are :

- Learn new things ;
	examples :
	how to code, 
	how to setup a github repository,
	how to setup GNU-GPL license on github.

- Meet cool people ;
	examples : 
	can give opportunities to meet programers in convention/JAM or ,
	meet artists in a event,
	maybe make friendships. [^we never know :) ]

- Enhance your programming skills ;
	examples :
	nothing to say all is in the title.

- And have fun while working on the project ;
	examples :
	have a good time when we test the online multiplayer,
	finding cool bugs.

-Definitions

The Github language

What is a license on Github ?

So a license is a very important a text file for an open-source project like PrBoom-Plus-Enhanced. This document set the legal terms and conditions for using, distributing, and modifying the code of a software. They allow others to contribute and improve the sofware, build a community around the project and also protect the rights of the software users.

Here is the website of "free software foundation" for more informations.

• https://www.fsf.org/

Small definition of GNU-GPL :

GNU is an extensive collection of free software, which can be used as an operating system or can be used in parts with other operating systems. The use of the completed GNU tools led to the family of operating systems popularly known as Linux. Most of GNU are licensed under the GNU Project's own General Public License (GPL).

The Doom language

What is a source port ?

For simple a source port is a software based on the source code of a game engine (linuxdoom 1.10) like the Doom Engine also called Id Tech 1 it's basically Doom 1, Doom 2 and many others licensed games like Hexen, Heretic, Blood, Duke Nukem 3D etc.

A source port allows the game to be played on operating systems and computing platforms with which the game wasn't originally compatible. (Thats why Doom run onerything)

The Homebrew language

What is a homebrew ?

In the easyest way to say, a homebrew is a game/software made by the hobbyists for proprietary video game consoles which are not intended to be user-programable. (hack your console and program an app with sdk, toolchain)

-How to be a contributors on this project

Everyone can be a contributor and can contribute to this open-source project. You can submit some logos, some sprites, some maps (Why Not), some code/scripts, some mods/wads/pk3 or just some texts. You don't need to be experiemented to contribute to this project. To share your ideas you have the github channel and the discord channel too. You don't a big devices to help to create this software/homebrew port. Keep in mind that everything will be checked to avoid problems and that we will have to be convinced to add your ideas, such things as a vote or an event in the community would be appreciated you can choose.

-About the feedback, ideas

About the feedback, so you can discuss about on the project in the discussion channel of PrBoom-Plus-Enhanced on the Github. There are differents channels to talk for the purpose.

• https://github.com/Damnerz/PrBOOMplus-ENHANCED-3ds/discussions

Or just click on this link: - https://discord.gg/Xw9DEsbZdj Its the discord server of PrBoom-plus-Enhanced a way to bring the community together.

Give us a lot of bugs and a way to reproduce their behaviors, with explainations. Give us some syntax errors. We need your help.

-Nintendo 3DS

So you are in the Readme.md file for the Nintendo 3ds version of PrBoom-Plus-Enhanced.

So PrBoom-Plus-Enhanced gonna be port on the Nintendo 3ds Familly system (old and new models) as a Homebrew free but the originals wadfiles of DOOM are not provided. Get DOOM.wad DOOM2.wad get them on GOG.com or Steam.com (links below) Unless you can have the FreeDoom wadfiles for free : freedoom1.wad, freedoom2.wad and FreeDM on the official github/website. FreeDoom is a version of Doom free and libre with some tweaks and it's under the GNU General Public License (GPL).

Here you find the different models of Nintendo 3DS that you can buy on the market and the different abbreviations that you may encounter in a discussion.

Nintendo 3DS (also name old 3ds (o3ds) or 3ds fat for short),

Nintendo 3DS XL (also name old 3ds XL (o3ds XL) for short),

Nintendo 2DS (also name old 2ds (o2ds) or 2ds fat for short),

New Nintendo 3DS and New Nintendo 3DS XL (also name N3ds and N3ds XL for short),

New Nintendo 2DS XL (also N2ds XL for short).

All the 3ds systems can have this homebrew port with a hacked devices. But it's at you to search for how to hacked your 3ds system. The entire team behind PrBoom-Plus-Enhanced is not responsible if you break your devices.

-Game features

So first of all, some features will be enabled or disabled depending on the device you are using. example: on a Nintendo 3DS you can use the boutons on touch screen, on PC it's useless to have this feature, you have the idea ;).

Keep in mind PrBoom-plus-Enhanced is big and inspired of DSDA Doom and others cool features imported or recoded from others cool source ports. An others ideas.

Main features

In game :

ONE SCREEN MODE : -Be alble to play on one screen only. //taken from DsDoom (can boost performance)

CUSTOMIZE YOUR HUD : -Be able to customize position of HUD in the settings upper or lower screen. //taken from DsDoom

REMAPPABLE BUTTONS SHORTCUTS / MACROS : -On the bottom screen you are able to use 8 virtuals buttons as shortcuts. //taken from PrBoom-3DS

MOUSE LOOK : -Use the touchscreen as a virtual mouse. //rework of the PrBoom-Plus-3DS

VIRTUAL KEYBOARD : -Use the touchscreen as virtual keyboard. //taken from DsDoom

BOTTOMSCREEN MAP : -Use the bottomscreen to show the map at the same time you play the game. //taken from PrBoom-3DS

BOTTOMSCREEN MAP : -Use the bottomscreen to show the doomguy HUD. //taken from DsDoom

BOTTOMSCREEN COORDINATES : -Use the bottomscreen to show the coordinates of doomguy. //taken from PrBoom-3DS

BOTTOMSCREEN BLACK SCREEN SHORTCUT : -Buttons on the bottomscreen to show the map, to show the keyboard, to show the mouse. //made and taken from PrBoom-Plus-3DS

KEY MAPPING : -"In game/launcher it's in the .3dsx", working key mapping or using the text editor built-in the launcher you are able to modify and use multiples configurations files and arguments.

SCREENSHOTS : -Working screenshots in a special folder in the disk/sdcard.

POTATO MODE : A feature taken from FastDoom DOS. 80*50 pixels (For ultra Low Resolution usefull when you use demanding wads for the device.)

Launcher :

LAUNCHER : Inspiration on Doom-it and ZDL -A gui with ease to use, for managing and launch your wads and dehackeds and launch them. (multiples wads and dehackeds at the same time) A box to customs small arguments to launch demos etc. Launch custom online game with gui to enter port and ip address and thing related to servers. In this launcher you can modify your text file with text editor built-in.

-Installation process

%%for now no more details beacuse you know it's like every homebrews on 3ds i will explain that later:)%%

On a Nintendo 3DS

on sd card

In FBI with a .CIA

On an Emulators

using sdmc (virtual sd card)

with the emulator using .CIA

-Related repos of the project

PrBoom-Plus-Enhanced Nintendo 3DS

• https://github.com/Damnerz/PrBOOMplus-ENHANCED-3DS ;

PrBoom-Plus-Enhanced Launcher

• https://github.com/Damnerz/PrBOOMplus-ENHANCED-launcher ;

-Extra links

Get Doom

Freedoom

Website and github for the freedoom wadfiles :

• https://github.com/freeDoom/freeDoom

• https://freeDoom.github.io/

Get the original Doom's wadfiles to purchase here :

Doom 1

• https://www.gog.com/fr/game/Doom_1993 ;GOG website Doom 1

• https://store.steampowered.com/app/2280/DOOM_1993/ ;Steam Website Doom 1

Doom 2

• https://store.steampowered.com/app/2300/DOOM_II/ ;Steam Website Doom 2

• https://www.gog.com/fr/game/Doom_ii ;GOG website Doom 2

Others wadfiles will be compatible like Ultimate Doom Chex Quest and HACX.

Github profile links

Here are the repositories at their respective original github profile.

• https://github.com/coelckers ;maker of PrBoom-Plus source port.

• https://github.com/Voxel9 ;maker of PrBoom-Plus 3DS the port of PrBoom-Plus as a Nintendo 3DS homebrew.

• https://github.com/TheChuckster ;maker of DsDoom a the Nintendo DS port of Doom as homebrew.

• https://github.com/devinackers ;maker of the PrBoom Nintendo 3DS port as homebrew.

Go check out their github profile because they are cool.

Wikis and websites

[^If you need to check something???]

The officials things.

• https://en.wikipedia.org/wiki/Doom_(1993_video_game) ;the Doom story

• https://github.com/id-Software/DOOM ;the base of all sources ports, here it is the Linux Doom source code on github released by John CARMACK himself.

The story of Doom's sources ports:

• https://doomwiki.org/wiki/Source_port ;DoomWiki Doom's sources ports stories and explainations.

The simplified tree of Doom's sources ports :

• https://www.doomworld.com/forum/topic/98216-doom-source-ports-family-tree-simplified-for-wikipedia/

The BOOM branch based on Doom, Linux Doom, and DOSDoom.

• https://doomwiki.org/wiki/DOSDoom ;DoomWiki DOSDoom

• https://doomwiki.org/wiki/Boom ;DoomWiki Boom

• https://doomwiki.org/wiki/PrBoom ;DoomWiki PrBoom

• https://DoomWiki.org/wiki/PrBoom%2B ;DoomWiki Prboom-Plus

• https://DoomWiki.org/wiki/MBF ;DoomWiki MBF port

• https://DoomWiki.org/wiki/DSDA-Doom ;DoomWiki DSDA Doom port

Doom on everything ////

More about about source ports go check out those links

• https://en.wikipedia.org/wiki/Source_port ;
• https://en.wikipedia.org/wiki/List_of_Doom_ports ;

Here is some examples of Nintendo Devices where you can play Doom on it:

Nintendo Officials and Unofficials Doom ports/sources ports as homebrews.

Super Nintendo Entertainment System (SNES)

---

Official SNES port on real cartridge from 1995.

• https://doom.fandom.com/wiki/Super_NES ;Doom fandom SNES Doom
• https://github.com/RandalLinden/DOOM-FX ;Github SNES Doom source code

&

"Un""Official"" SNES port on real cartridge from 2025. ^soon^

• important to annoted this cause this game will be very optimized.

Gameboy Advance (GBA)

---

Official GBA port on real cartridge.

• https://doom.fandom.com/wiki/Game_Boy_Advance ;Doom fandom GBA Doom official port

Unofficial GBA homebrew.

• https://github.com/doomhack/GBADoom ;GBA Doom PrboomGBA Github

Nintendo DS/DSi

---

Unofficials homebrews ports.

DSDoom Homebrew

• https://DoomWiki.org/wiki/DS_Doom ;DoomWiki DsDoom
• https://Doom.fandom.com/wiki/DsDoom ;Doom fandom DsDoom
• https://www.gamebrew.org/wiki/DS_Doom ;Gamebrew webpage of DsDoom

DS Chocolate Doom Homebrew

^more researches is needed^

Nintendo 3DS

---

Unofficials Homebrews ports.

PrBoom3DS Homebrew

• https://Doom.fandom.com/wiki/Prboom3DS ;Doom fandom PrBoom3DS
• https://github.com/devinacker/prboom-3ds ;Github of the maker of the PrBoom-3DS
• https://www.gamebrew.org/wiki/Prboom_3DS ;Gamebrew webpage of PrBoom 3DS
• https://www.gamebrew.org/wiki/PrBoom3DS ;Gamebrew webpage of PrBoom3DS

PrBoom-Plus-3DS

• https://github.com/Voxel9/PrBoom-Plus-3DS ;Github webpage of PrBoom-Plus-3DS

                       =================     ===============     ===============   ========  ========                                                             
                        \\ . . . . . . .\\   //. . . . . . .\\   //. . . . . . .\\  \\. . .\\// . . //
                        ||. . ._____. . .|| ||. . ._____. . .|| ||. . ._____. . .|| || . . .\/ . . .||
                        || . .||   ||. . || || . .||   ||. . || || . .||   ||. . || ||. . . . . . . ||
                        ||. . ||   || . .|| ||. . ||   || . .|| ||. . ||   || . .|| || . | . . . . .||
                        || . .||   ||. _-|| ||-_ .||   ||. . || || . .||   ||. _-|| ||-_.|\ . . . . ||
                        ||. . ||   ||-'  || ||  `-||   || . .|| ||. . ||   ||-'  || ||  `|\_ . .|. .||
                        || . _||   ||    || ||    ||   ||_ . || || . _||   ||    || ||   |\ `-_/| . ||
                        ||_-' ||  .|/    || ||    \|.  || `-_|| ||_-' ||  .|/    || ||   | \  / |-_.||
                        ||    ||_-'      || ||      `-_||    || ||    ||_-'      || ||   | \  / |  `||
                        ||    `'         || ||         `'    || ||    `'         || ||   | \  / |   ||
                        ||            .===' `===.         .==='.`===.         .===' /==. |  \/  |   ||
                        ||         .=='   \_|-_ `===. .==='   _|_   `===. .===' _-|/   `==  \/  |   ||
                        ||      .=='    _-'    `-_  `='    _-'   `-_    `='  _-'   `-_  /|  \/  |   ||
                        ||   .=='    _-'          '-__\._-'         '-_./__-'         `' |. /|  |   ||
                        ||.=='    _-'                     ___________                     `' |  /==.||
                        =='    _-'                        Since  1993                         \/   `==
                        \   _-'                           ===========                          `-_   /
                         `''                                                                      ``'