|
|
| (72 intermediate revisions by 12 users not shown) |
| Line 1: |
Line 1: |
| <!-- | | <div style="overflow-x:scroll"> |
| Notes area.
| | {{Alert|Note: OuroDev is purely a not-for-profit, volunteer group. Anyone asking for donations on behalf of OuroDev or any of its contributors does not represent the group and should be ignored.}} |
| | |
| Stole some of the layout inspiration from gametech emugen wiki.
| |
| | |
| TODO: Adapt the structure of the main page to move Howtos to their own sections, and also consolidate specific component topics. I sent the below suggested basic structure to TMC earlier. This is simply a concept for content and organization, and it doesn't have to be followed to the letter, but these are my thoughts in any case. --Bevinsky
| |
| | |
| Walkthroughs
| |
| - [[Basic i24 Walkthrough]]
| |
| - [[Basic i25 Walkthrough]]
| |
|
| |
| # i24 and i25 are very similar. Instead of having separate pages
| |
| # for each of these items, it might be better to cover differences on each page.
| |
| # -- Perhaps this is not a desired idea?
| |
| | |
| # document directory structure:
| |
| # - Executable/datadir structure
| |
| # - other dirs, such as C:\coh_data\attributes?
| |
| [[Directories]]
| |
| | |
| # Should assemble magnet links for specific assets?
| |
| [[Assets]] # explain client piggs/bins, server bins, maps, SpawnAreas, script.loc
| |
| - [[maps.db]] # Usage, format and directives
| |
| - [[Templates & Attributes]] # template purpose, usage, generation method, and syntax
| |
| | |
| # Document for each:
| |
| # - Location
| |
| # - Purpose, usage
| |
| # - Full directive reference / file format
| |
| Configurations
| |
| - [[gamedatadir.txt]]
| |
| - [[servers.cfg]]
| |
| - [[loadBalance]] # for both loadBalanceDefault.cfg and loadBalanceShardSpecific.cfg
| |
| - [[auction_server.cfg]]
| |
| - [[account_server.cfg]]
| |
| - [[chat_server.cfg]]
| |
| - [[commands.cfg]]
| |
| - [[weeklytf.cfg]] # shouldn't this be "weeklyTF.cfg"? is this changed in i25 or is it case-insensitive?
| |
| - [[version.ini]]
| |
| | |
| # Document for each component:
| |
| # - basic purpose, usage
| |
| # - command line flags reference
| |
| # - common issues
| |
| # - etc.
| |
| [[Servers]] # Architecture description?
| |
| - [[DBserver]]
| |
| - [[Mapserver]]
| |
| - [[Launcher]]
| |
| - [[Chatserver]]
| |
| - [[Authserver]]
| |
| - [[Accountserver]]
| |
| - [[Arenaserver]]
| |
| - [[Missionserver]]
| |
| - [[Auctionserver]]
| |
| - etc? are there more?
| |
| | |
| Tools
| |
| - [[pig.exe]]
| |
| - [[ServerMonitor]]
| |
| | |
| Protocols?
| |
| - Inter-server?
| |
| - ?
| |
| - Server-client?
| |
| - [[Client-to-authserver]]
| |
| - [[Client-to-dbserver]]
| |
| - [[Client-to-mapserver]]
| |
| | |
| Formats?
| |
| - [[PIGG]] # pig.exe
| |
| - [[Parse6]]
| |
| - [[Parse7]]
| |
| | |
|
| |
|
| | {| style="width:100%; background:#fafafa; margin-top: 0.6em; border:1px solid #a2a9b1; padding: 0 4% 0 8%;" |
| | | style="width:65%;" | |
|
| |
|
| | {| style="border:none; background:none;" |
| | | style="text-align:center; white-space:nowrap;" | |
| | <div style="font-size:162%; border:none; padding:.1em;">Welcome to OuroWiki,</div> |
| | <div style="top:+0.2em; font-size:95%;">the Project Ouroboros Development wiki.</div> |
| | <div id="articlecount" style="width:100%; text-align:center; font-size:85%;">We are hosting [[Special:AllPages|{{NUMBEROFPAGES}}]] pages.</div> |
| | <div id="visionstatement" style="width:100%; text-align:center; font-size: 85%">Please read our [[OuroDev_Volume_2_Vision|Vision Statement]].</div> |
| | |} |
| | <!-- |
| | | style="width:40%; font-size:85%; padding:0.6em; padding-right:5%" | |
| | The '''Ouroboros''' Project is an ongoing volunteer effort. Please read our [[OuroDev_Volume_2_Vision|Vision Statement]]. |
| --> | | --> |
| {| style="width:100%; background:#4a2a2a; margin-top: 0.6em; border:1px solid #a2a9b1; text-align:center; font-weight:bold"
| | | style="width:35%; white-space:nowrap;" | |
| || | | :[[File:Discord.png|30x30px|link=OuroDev Discord]] <span style="font-size:120%">[[OuroDev Discord|Discord]]</span> <span style="font-size:85%">(Discussion)</span> |
| Note: OuroDev is purely a not-for-profit, volunteer group. Anyone asking for donations on behalf of OuroDev or any of its contributors does not represent the group and should be ignored.
| | :[[File:GitLab Icon.png|30x30px|link=https://git.ourodev.com/CoX/Source]] <span style="font-size:120%">[https://git.ourodev.com/CoX/Source Gitlab]</span> <span style="font-size:85%">(Source code, bug tracking)</span> |
| | :[[File:PortalCorps.png|30x30px|link=Portal Corps]] <span style="font-size:120%">[[Portal Corps]]</span> <span style="font-size:85%">(Content creation)</span> |
| |} | | |} |
|
| |
|
| {| style="width:100%; background:#2a2a2a; margin-top: 0.6em; border:1px solid #a2a9b1; padding: 0 8%;" | | {| style="width:100%; margin-top: 0.6em" |
| | style="width:15%;" |
| | | colspan="2" style="width:50%; background:#fafafa; border:1px solid #a2a9b1; padding:0.6em; vertical-align:top" | |
|
| |
|
| {| style="width:100px; border:none; background:none;"
| | <h2 style="margin-top:0;padding-top:0">Volume 2</h2> |
| | style="text-align:center; white-space:nowrap;" |
| | Volume 2 is the main focus of OuroDev's ongoing efforts to clean up and modernize the City of Heroes (CoH) code, completely open source. The current version is "''Issue 2: Foundations of Tomorrow"'' |
| <div style="font-size:162%; border:none; padding:.1em;">Welcome to OuroWiki,</div> | |
| <div style="top:+0.2em; font-size:95%;">the Ouroboros Project wiki.</div>
| |
| <div id="articlecount" style="width:100%; text-align:center; font-size:85%;">There are [[Special:Statistics|{{NUMBEROFARTICLES}}]] articles already. Why not explore them?</div>
| |
| |}
| |
|
| |
|
| | style="width:40%; font-size:85%; padding:0.6em; padding-right:5%" | | | It is a stable base for server owners to deploy, and is built off of Issue 24 (stylized as i24), the last open beta version of the game before it was shut down. |
| The '''Ouroboros Project''' is an ongoing volunteer effort that is taking a three-pronged approach to making City of Heroes available to the public:
| | |- style="vertical-align:top" |
| # Actively providing documentation and support for setting up private deployments using released 'i25' binaries and 'i24' source.
| | | |
| # Maintaining and releasing stable builds of the 'i24' client and server, including a public git repo and public bug tracker.
| | ====Volume 2 Server Setup==== |
| # Providing a public wiki for documentation and transparency.
| |
|
| |
|
| | style="width:10%; font-size:120%; white-space:nowrap;" |
| | *[[Volume 2 VMs & Self Installer|Volume 2 VMs & Self Installer]] |
| : [[File:Gitea.png|30px|link=https://git.ourodev.com/CoX/Source]] [https://git.ourodev.com/CoX/Source Gitea]
| | *[[Volume 2 Server Setup|Volume 2 Getting Started]] |
| : [[File:Mantis.png|30px|link=https://bugs.ourodev.com/]] [https://bugs.ourodev.com/ Mantis]
| | *[[Volume_2_Modifying_Server_For_External_Access|Volume 2 Modifying Server For External Access]] |
| : [[File:Discord.png|30px|link=OuroDev Discord]] [[OuroDev Discord|Discord]]
| | *[[Volume_2_Client_setup|Volume 2 Client setup]] |
| |} | | | |
| | ====Volume 2 From Source==== |
|
| |
|
| {| style="width:100%; margin-top: 0.6em"
| | *[[Volume_2_Build|Volume 2 Build from Source]] |
| | style="width:75%;vertical-align:top;padding-right:0.6em" |
| | *[[Volume 2 Generate Bins]] |
| {| style="width:100%; background:#2a2a2a; border:1px solid #a2a9b1; padding:0.6em; vertical-align:top"
| | |- style="vertical-align:top" |
| | style="width:100%" colspan=4 |
| | | |
| <h2 style="padding-top:0;margin-top:0">[[Server Architecture]]</h2>
| | ====Volume 2 Details==== |
| |- | |
| | style="width:25%; vertical-align:top" |
| |
| <h3 style="padding-top:0;margin-top:0"> Assets </h3>
| |
| * [[Server directory structure|Directory structure]]
| |
| ==== Binary assets ==== | |
| * [[BCN maps]]
| |
| ==== Textual assets ====
| |
| * [[maps.db]] ''configuration?''
| |
| * [[script.loc]]
| |
| * [[SpawnArea]]
| |
| * [[Templates]]
| |
|
| |
|
| | style="width:25%; vertical-align:top" |
| | *[[OuroDev_Volume_2_Vision|Volume 2 Vision]] |
| <h3 style="padding-top:0;margin-top:0"> Components </h3>
| | *[[Volume_2_Release_Notes|Volume 2 Release Notes]] |
| * [[dbserver]] | | *[https://git.ourodev.com/groups/CoX/-/milestones Volume 2 Roadmap] |
| * [[mapserver]] | | *[https://git.ourodev.com/CoX/Source Volume 2 Source] |
| * [[launcher]] | | *[https://git.ourodev.com/CoX/i2401-bin-server Volume 2 Data] |
| * [[chatserver]] | | | |
| * [[authserver]] | | ====Volume 2 Workflow==== |
| * [[accountserver]]
| |
| * [[arenaserver]]
| |
| * [[missionserver]]
| |
| * [[auctionserver]]
| |
|
| |
|
| | style="width:25%; vertical-align:top" |
| | *[[OuroDev_Git_Workflow|OuroDev Git Workflow]] |
| <h3 style="padding-top:0;margin-top:0"> Configurations </h3>
| | *[[OuroDev_issue_tracker_workflow|OuroDev Issue Tracker Workflow]] |
| * [[servers.cfg]] | | *[[OuroDev_QA_workflow|OuroDev QA Workflow]] |
| * [[loadBalance]] | | *[[OuroDev_Code_Style_Guide|OuroDev Code Style Guide]] |
| * [[auction_server.cfg]] | | *[[OuroDev_Bug_Report_Guidelines|OuroDev Bug report Guidelines]] |
| * [[account_server.cfg]] | | |- style="vertical-align:top" |
| * [[chat_server.cfg]] | | | |
| * [[commands.cfg]]
| | ====Launchers and Manifests==== |
| * [[weeklytf.cfg]]
| |
| * [[Other configurations]]
| |
|
| |
|
| | style="width:25%;vertical-align:top" |
| | *[[Manifest Launchers]] |
| <h3 style="padding-top:0;margin-top:0"> Tools </h3>
| | *[[Manifest Creation]] |
| * [[pig.exe]] | | *[[Sunrise Launcher]] |
| * [[ServerMonitor]] | | *[[Sunrise API]] |
| * [[dbquery.exe]] | |
|
| |
|
| === Protocols ===
| | <br /> |
| * [[Network protocol]]
| | | |
| ==== Client-server protocols ''Does this need its own page?'' ==== | | ====Modding==== |
| * [[Client-to-authserver]]
| |
| * [[Client-to-dbserver]]
| |
| * [[Client-to-mapserver]]
| |
| ==== Server protocols ====
| |
| * [[Dbserver-protocols]]
| |
|
| |
|
| |}
| | *[https://git.ourodev.com/mods Community Mods] |
| | style="width:25%;vertical-align:top" |
| | *[[Bin List]] |
| {| style="width:100%; background:#2a2a2a; border:1px solid #a2a9b1; padding:0.6em; vertical-align:top"
| | *[[Binning File Layout]] |
| | style="width:100%" colspan=1 |
| | *[[XLS to data conversion]] |
| <h2 style="padding-top:0;margin-top:0">[[Client Architecture]]</h2>
| | *[[Portal Corps|Portal Corps Modding Guides]] |
| |- | | *[[Piglet|Piglet]] |
| | style="width:100%;" | | | *[https://git.ourodev.com/community Community Tools] |
| <h3 style="padding-top:0;margin-top:0"> TODO </h3>
| | |- style="vertical-align:top" |
| * TODO
| | | |
| |}
| | ====Useful References==== |
|
| |
|
| |} | | *[[Magnet Links]] |
| | *[[Admin_Commands_(in-game)|Admin Commands (in-game)]] |
| | *[[Combat Log |Combat Log]] |
| | *[[Server Executable Flags]] |
| | *[[Badge List]] |
| | *[[Salvage List]] |
| | *[[Using /mmm]] (in-game console) |
| | *[[VidiotMaps]] |
| | *[https://cohrevival.com/codex/models.html Model Index] |
|
| |
|
| {| style="width:100%; background:#2a2a2a; margin-top: 0.6em; border:1px solid #a2a9b1; text-align:center; font-size:130%"
| | <br /> |
| | style="width:50%" |
| | | |
| [[i24 install guide|I want to help develop!]]
| | ====I25/I26==== |
| | style="width:50%" |
| |
| [[i25 Community Virtual Machines|I just want to run a server!]]
| |
| |}
| |
|
| |
|
| {| style="width:100%; margin-top: 0.6em"
| | *[[I25 Main Page]] |
| | style="width:50%; background:#2a2a2a; border:1px solid #a2a9b1; padding:0.6em; vertical-align:top" |
| | *[[I25 Main Page#Server Setup Guide]] |
| | *[[I25 Main Page#Reference Documents]] |
|
| |
|
| <h2 style="margin-top:0;padding-top:0">Issue 24</h2> | | <br /> |
| Issue 24 (stylized as i24) was the last publicly accessible version of the game before it was shut down. i24 was deployed on the test server, but had not yet been released to live servers.
| | |- style="vertical-align:top" |
| | | colspan="2" | |
| | {| style="width:100%; background:#fafafa; border:1px solid #a2a9b1; padding:0.6em; vertical-align:top" |
| | | colspan="4" style="width:100%" | |
| | <h2 style="padding-top:0;margin-top:0">[[How It Fits Together|Architecture]]</h2> |
| | |- style="vertical-align:top" |
| | | style="width:25%; vertical-align:top" | |
| | <h5 style="padding-top:0;margin-top:0"> Assets </h5> |
|
| |
|
| === Guides ===
| | *[[Server directory structure|Directory structure]] |
| * Setup guide: https://docs.google.com/document/d/10FimduxDEM3UT1g7b6y3UHAETSjUl5lYzaG7fbUn-Vc/edit# (this is slowly being migrated over to here on the wiki).
| | *[[system_architecture_image|System Architecture Image]] |
| * [[source locations|Where to get the source]] | | *[[Piggs]] and [[Hoggs]] |
| * [[i24_install_guide|Install guide for setting up i24]] | |
| * [[i24 Common Setup Issues]]
| |
| * [[i24 Commands|i24 admin commands (in-game)]] | |
| * [[Server Configuration Values]]
| |
| * [[Server Executable Flags]]
| |
| * [[Using /mmm]] (in-game console)
| |
|
| |
|
| === Documentation === | | =====Binary assets===== |
| * [[system_architecture_image|System Architecture Image]]
| |
| * [[map_server_overview|Map Server]]
| |
|
| |
|
| === Tools Needed ===
| | *[[BCN maps]] |
| * An installation of Windows (verified working: 10 Pro, Server 2019 Standard)
| | *[[.bin files]] |
| * [http://download.microsoft.com/download/D/B/C/DBC11267-9597-46FF-8377-E194A73970D6/vs_proweb.exe Visual Studio 2010 Professional] Web download | |
| * [https://www.microsoft.com/en-us/download/details.aspx?id=29062 Microsoft® SQL Server® 2012 Express] | |
| * [https://docs.microsoft.com/en-us/sql/ssms/download-sql-server-management-studio-ssms?view=sql-server-2017 SQL Server Management Studio] (SMSS)
| |
|
| |
|
| === Torrent links === | | =====Textual assets===== |
| * Putting this here for now, can go away once we have the repository set up:
| |
| ** [[magnet links]]
| |
|
| |
|
| === Useful Future Links? ===
| | *[[maps.db]] |
| * [https://cohrevival.com/codex/models.html Model Index] | | *[[script.loc]] |
| | *[[SpawnArea]] |
| | *[[Templates]] |
| | *[[.def_Files]] |
|
| |
|
| === Git Repository === | | | style="width:25%; vertical-align:top" | |
| * [[OuroDev_Git_Workflow|OuroDev Git Workflow]] ''TODO: move this to an OuroDev section''
| | <h5 style="padding-top:0;margin-top:0"> Components </h5> |
|
| |
|
| | style="width:50%; background:#2a2a2a; border:1px solid #a2a9b1; padding:0.6em; vertical-align:top" |
| | *[[accountserver]] |
| | *[[arenaserver]] |
| | *[[auctionserver]] |
| | *[[AuthServer]] |
| | *[[beaconizer]] |
| | *[[chatserver]] |
| | *[[dbserver]] |
| | *[[launcher]] |
| | *[[mapserver]] |
| | *[[missionserver]] |
| | *[[queueserver]] |
|
| |
|
| <h2 style="margin-top:0;padding-top:0">[[i25 Main Page|Issue 25]]</h2> | | | style="width:25%; vertical-align:top" | |
| Issue 25 (stylized as i25) was extended from an i24 base by SCoRE (Secret Cabal of Reverse Engineers) over the course of six years. It included additional content for i24 power sets, added the P2W Vendor, and fixed a good number of bugs.
| | <h5 style="padding-top:0;margin-top:0"> Configurations </h5> |
|
| |
|
| === Client Setup Guide ===
| | *[[account_server.cfg]] |
| * [[i25 Client Setup]] | | *[[auction_server.cfg]] |
| | *[[chat_server.cfg]] |
| | *[[commands.cfg]] |
| | *[[config.txt]] |
| | *[[loadBalance]] |
| | *[[servers.cfg]] |
| | *[[turnstile_server.cfg]] |
| | *[[version.ini]] |
| | *[[weeklytf.cfg]] |
|
| |
|
| === Server Setup Guide === | | | style="width:25%;vertical-align:top" | |
| * [[i25 Server Setup]]
| | <h5 style="padding-top:0;margin-top:0"> Tools </h5> |
| * [[i25 Multiple Server Setup]]
| |
| * [[i25 Community Virtual Machines]]
| |
| * [https://gofile.io/?c=w56I8R Video Guide from scratch]
| |
| * [https://docs.google.com/document/d/1N63pPUfll-PAiElfGatSqCvX7GHZ8ygHWHAYbAV5il0/edit Original Setup Instructions on Google Drive]
| |
|
| |
|
| === Commonly Asked Questions/Problems ===
| | *[[Client Mirror Distribution Project]] |
| * [[i25 FAQ]] | | *[[dbquery.exe]] |
| * [[i25 Current Status]] | | *[[ServerMonitor]] |
| * [[i25 Command Lists]] | |
|
| |
|
| === Downloads and Community Tools === | | =====Protocols===== |
| * [[i25 Downloads]]
| |
| * [[i25 Populate Auction Server]]
| |
|
| |
|
| === Reference Documents ===
| | *[[Network protocol]] |
| * [https://drive.google.com/file/d/1eZqIZnhEYDoRAJeoCotyKhWZZG07mrft/view City of Heroes Document] | |
|
| |
|
| === i25 Patch Notes === | | =====Client-server protocols===== |
| * [https://docs.google.com/document/d/11cLJiSYlfueJheOumRywG8Evip2Mjmu_30Y6ePaetqY i25 Patch Notes]
| |
|
| |
|
| |}
| | *[[Client-to-authserver]] |
| | *[[Client-to-dbserver]] |
| | *[[Client-to-mapserver]] |
|
| |
|
| {| style="width:100%; background:#2a2a2a; margin-top: 0.6em; border:1px solid #a2a9b1; padding:0.6em; vertical-align: top"
| | =====Server protocols===== |
| | style="width:100%; vertical-align:top" |
| |
|
| |
|
| == Quality of Life ==
| | *[[Beaconizer-protocols]] |
| * [[VidiotMaps]] (suitable for use with either i24 or i25) | | *[[Dbserver-protocols]] |
| * [[Account_Portal]] (A PHP application to allow users to create their own accounts and change their passwords.) | |
|
| |
|
| |} | | |} |
| | |}</div> |
|
| |
|
| __NOTOC__ | | __NOTOC__ |
