gfx gfx
gfx gfx
Please login or register.

Login with username, password and session length
gfx gfx
gfx gfx

  • !!!!!!!!!!!!!!!!!!!!!!!!ATTENTION!!!!!!!!!!!!!!!!!!!!!!!!!
    !!!!!!!IMPORTANT NEWS! READ THIS!!!!!
    !!!!!!!!!!!!!!!!!!!!!!!!ATTENTION!!!!!!!!!!!!!!!!!!!!!!!!!

  • D2Maniacs closed after 12 years of service its doors.
    This not only affects the D2M board and the realm but also this board!
    You can expect a servermove of this board within the next weeks!!
  • Just incase unexpected things happen bookmark this 2 domains
    www.snej.org
    www.d2se.org
    To stay connected to us.
    I will ask Jebs to keep a permanent redirect from our old board after the move

  • I will write a announcement as soon as i have more informations
    to keep you updated
     
gfx gfx
gfx
October 31, 2014, 04:29:59 pm
*
gfx gfx
gfx* Home Help Search Login Registergfx

Author Topic: D2SE Modmanager [english/german]  (Read 243562 times)

0 Members and 2 Guests are viewing this topic.

Offline SeltsamuelTopic starter

  • Administrator
  • Trade Count: (0)
  • Duriel
  • **
  • Posts: 1766
  • Gender: Male
    • Snej-Mod Homepage
D2SE Modmanager [english/german]
« on: March 21, 2010, 03:47:23 pm »

DISCLAIMER



D2SE Modmanager is a part of the D2SE Modsystem copyright 2008 by Seltsamuel.

The Modsystem is for Diablo II and its expansion Lord of Destruction Copyright by Blizzard Entertainment.
D2SE Modmanager contains only UNMODIFIED dlls and patchfiles from LOD that are freely downloadable at many places with permission of Blizzard. I do not claim any copyrights for them because its property of Blizzard Entertainment.

The Modmanager interface graphics are copyright by SamusAran.


This program is free software. I (Seltsamuel) grant permission to use, linkto and redistribute the ORIGINAL and UNMODIFIED Installer and its complete documentation inside this board without further notification according to the following TERMS:

  • You MUST own a valid license of Diablo II and LOD. I do not support any piracy.
    if you dont have the original you are not allowed to use D2SE and have to delete it immediately!

  • You are not allowed to do ANY modifications of the D2SE Modmanager, its freeware but this means not that it has no copyright.
    The purpose of the Modmanager is to give ONE similar platform to all modders and players - spreading modified versions and forks is against this spirit. If you want to enhance it or have ideas to improve it get in contact with me, D2SE in all parts is under continuing development.

  • You are not allowed to charge ANY money for D2SE Modmanager.

  • This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. This software is provided "AS IS", and you, its user, assume all risks when using it.



I tried to keep it free and simple for you, so i hope nobody forces me to make it more restrictive ;-)

Seltsamuel


« Last Edit: April 01, 2010, 01:15:51 am by Seltsamuel »

Offline SeltsamuelTopic starter

  • Administrator
  • Trade Count: (0)
  • Duriel
  • **
  • Posts: 1766
  • Gender: Male
    • Snej-Mod Homepage
D2SE Modmanager [english/german]
« Reply #1 on: March 23, 2010, 02:33:49 pm »

D2SE - what's that?


D2SE generally is an own modsystem which was originally developped by myself for Snej Mod. I saw many advantages for all players and modders, so I decided to reconfigure the whole system in a way that every Diablo2 Mod can benefit from.

D2SE consists of two main components:
1. The Modmanager, which is interesting for players as well as for modders
2. The Code Modsystem which is mainly meant to be used by modders

This part mostly is about the Modmanager, which is released. The Codesystem will follow when it will be finished. I devided this instruction to get a better overview for players and modders. Firstly the features which are interesting for both sides:

The D2SE Modmanager allows you to use the Diablo2 versions 1.07 1.08 1.09b 1.09d 1.10f 1.11b 1.12a 1.13c AND nearly every Mod which is based on one of these D2 versions in parallel. The D2 versions (almost 13MB) are already included in the basic installation of D2SE (from now on called "CORES") and therefore are guaranteed clean and identical bases for all mods and players. The mods are NOT included and have to be installed seperately. This will be explained in the appropriate topic where the downloads are. There wont be ANY copied or changed files while switching between a mod or D2 version. Also, the mods don't have to bring ANY unmodified files - just the basically modded ones, which makes a distribution simple and way more smaller. No more unnecessary files in your mod - you can concentrate on the basics now.




D2SE supports the following Modsystems: PlugY 9.0 (Cores 1.09b-1.12a), d2mod.dll (Core 1.10f only!), nefex.dll (Core 1.11b only!), D2Extra.dll (Cores it was created for) and - for sure - the D2SE Codesystem plus the D2SEUtility.dll (all supported Cores!) which will be released before the Codesystem. D2SE allows you to load modified D2 .dll's directly from the modfolder. All .dll's which do not exist in this folder will be loaded from the clean core folder of the specific version - fully automated. Additionally, Plugy can be enabled or disabled individually (for each mod which allows it) at the graphical user interface of D2SE via checkbox.

D2SE gives an own "save" folder to each mod and Core for all savefiles which are located IN the mod/Core folder. This also applies to the Plugy shared stash and all logs and screenshots. A clear slogan: Everything which belongs to a mod is IN the specific mod folder - nowhere else!

D2SE defends all D2 Cores and mods from DEP (Data Execution Prevention) and fixes an issue with the AERO Windowsinterface of Win7 and Vista (counting numbers in one edge of the screen). So AERO can stay turned on! As a bonus, the ability to start multiple instances of Diablo2 to be able to mule in SP/MP is allowed. (But only the first instance is able to connect to a realmserver! Snej-players already know this feature) You just have to start D2SE.exe another time - as often as you want!

D2SE does NOT need a CD in your drive (applies to every mod and version) and informs you about problems with your installation (red/green CD symbol) by clicking on the CD symbol.

The choice between mods and core versions at the graphical user interface (GUI) is very comfortable. There you can make your settings, which are REMEMBERED by D2SE seperately and INDIVIDUALLY for each mod and core version. D2SE also REMEMBERS the mod/core version which you chose the last time, so you can simply press your "ENTER" key or click the "Start D2" button when you opened D2SE to run the mod/core version you ran at last - with the specific settings you made. If you want to start a mod quick, without changing your settings, simply doubleclick the banner of the mod you want to play. The D2Vidtst and the Glide-init are selectable directly so you can configure the graphic settings. You can adjust all important settings DIRECTLY.

D2SE offers free adjustable buttons to every mod. Those CAN link to "Readme" "About" "Homepage" "Forum" and "Configure Mod". In addition, every mod can load up to 3 own .mpq files (which you can name by yourself) and with a higher priority than patch_d2. you can even deactivate loading patch_d2.mpq - more details in the instructions for modders.

D2SE sets the correct Realmserver as Gateway for all mods which have realmsupport. It also changes the realmport to the right one AND correctly selects the realm of the specific mod in the charselection screen ... automatic. No more fiddling about regfiles or regeditors and no more forgetting to choose the right realm. ^^

D2SE soon will be able to update itself and every mod which supports this feature by a simple click via AUTOUPDATER.


You just have to keep this in mind:
- If you want to play all vanilla versions or mods in SP/MP (TCP) mode or on a private realm -> start D2SE.exe
- If you want to play legal and unmodified in the official Battle.net -> start the common Game.exe
You can update your D2 installation at anytime, even if D2SE does NOT know and therefore does not support this patch. This neither disturbs D2SE, nor any of the mods you can start via D2SE. D2SE makes its mods completely independent of Blizzard's Patchmania and allows you secure playing in the Battle.net despite you can play mods. But then you have to start Blizzard's Game.exe!!


Now I will go on to a detailed install guide in the next post.
Modders and those who are interested in technical stuff also can jump directly to the instruction for modders.

« Last Edit: August 07, 2011, 02:09:00 pm by Seltsamuel »

Offline SeltsamuelTopic starter

  • Administrator
  • Trade Count: (0)
  • Duriel
  • **
  • Posts: 1766
  • Gender: Male
    • Snej-Mod Homepage
D2SE Modmanager [english/german]
« Reply #2 on: March 23, 2010, 02:34:47 pm »

D2SE Modmanager Installation


As a player, you don't have to know much about how it works. Simply -> Download D2SE_V2.2.0.exe <- and install D2SE via the setup by doubleclicking the downloaded file.


You can quit the welcome-screen by clicking "Next".


Now you will be asked for the original path of your D2 installation. (The mainfolder with the Game.exe and the big .mpq files!) The installer automatically shows the right path, if it can be ascertained. If the shown path is not the right one you have to choose it manually via the "Browse" button. You can verify the path by clicking on the "Next" button.


At this point, you will be asked for a name of the folder for your shortcut in the startmenu. You can use the default, create something different, or click the checkbox so that no shortcut in your startmenu will be created. You can accept your settings with a "Next" as always.


This screen makes it possible to create shortcuts on your desktop or in the quick launch menu. You can verify your settings by clicking on "Next" again.


This is an overview of the settings you made. You can accept them by clicking on "Install" or edit them by clicking on the "Back" button, which is integrated in every screen.


As soon as the installation bar is finished, you will see this screen, which informs you about the successful installation. In addition, you can let the checkbox checked, which will start D2SE right after you closed the installation by clicking on "Finish".


Congratulations! The D2SE Modmanager is now ready for action. All supported D2 versions should be able to play now. Here is a permanently growing list including links (to mods which are compatible with D2SE) and the specific install guides.
From now on "Modmodules which are compatible with D2SE" I will call "Modplugins". If you want to run a mod with D2SE by yourself you should read the instructions for modders in the next post. It is really really easy to create an own D2SE Modplugin and only requires to configure one single file: The D2SE_SETUP.ini ... but you can read it yourself in the next post if this interests you. If it doesn't, I wish you a lot of fun playing this huge amount of D2 versions and already available D2 Modplugins with D2SE.



PS:
Here I made a short overview about the installed files, their meanings and the filestructure beyond, so that you know what the installer actually did.

MYD2 stands for the own D2 directory in this overview. In my case, this was D:\Diablo II.





MYD2\D2SE                      <- This is the D2SE systemfolder.
                                  It contains all important maincomponents.
                                  Generally it is imperative to: KEEP AWAY!!.
MYD2\D2SE\CORES                <- The clean D2 versions with all their .dll and patch_d2.mpq
                                  files are located here. Each version has its own folder
                                  and every single folder contains a SAVE directory for the
                                  savefiles. (in case of someone plays a vanilla version)
                                  Except from the the save folder you should: KEEP AWAY!
MYD2\D2SE\UTEMP                <- This folder is used by the Autoupdater to download
                                  and extract files from the internet. KEEP AWAY!!

MYD2\D2SE\X_optional_X         <- This folder is interesting because some optional files
                                  which you maybe want to use are located there. At the moment,
                                  there are only some .mpq files called "Stubfiles".
                                  These are .mpq files which are almost empty and which you can
                                  use to overwrite the original .mpq's in the D2 mainfolder.
                                  (which are named the same) Well you have to abstain from
                                  music and videos then, but you are saving several hundred
                                  MB of your diskspace.
MYD2\D2SE\7zr.exe              <- This file belongs to 7zip, a file packer / unpacker. It is used
                                  by the autoupdater to unzip the updates. KEEP AWAY!
MYD2\D2SE\Standard_Realm.reg   <- If you ever have problems while quitting D2SE and the
                                  original D2 realmgateways were not restored, you can reset it
                                  via doubleclicking this .reg file. This shouldnt be ever necessary,
                                  but i better prevent the case ;-)

MYD2\MODS                      <- This folder is empty after the installation.
                                  HERE you can extract your modplugins - each mod in its own folder.
                                  This is the place where modders can let off steam.
MYD2\PlugY                     <- This is the basic installation of Plugy 9.0 - here also applies:
                                  KEEP AWAY! All mods which use Plugy share these files.
                                  The modified Plugy files have to be IN the single modfolders, DON'T MODIFY ANYTHING!!!
                                  See Yohanns Plugy 9.0 for further informations, I save listing the details here ^^

The following 6 files are the ONLY ones, which D2SE installs directly into the D2 folder. No original files will be overwritten and the original installation stays untouched. None of the D2SE modplugins modifies anything outside of the own pluginfolder - this is the basic requirement of all D2SE modplugins!!!
 
MYD2\D2SE.exe                  <- This is the D2SE mainprogramm. To use D2SE simply
                                  start this exe.
MYD2\D2SE.ini                  <- This is the D2SE ini file. D2SE remembers which mod
                                  was played lastly here.
MYD2\glide3x.dll               <- The mainfile of the Glidewrapper by Sven Labusch.
MYD2\glide-init.exe            <- The tool to be able to configure the glidewrapper.
                                  D2SE lets you start the glidewrapper straight from the GUI.
MYD2\glide-liesmich.txt        <- documentation of the glidewrappers in german.
MYD2\glide-readme.txt          <- documentation of the glidewrappers in english.


« Last Edit: August 07, 2011, 02:10:43 pm by Seltsamuel »

Offline SeltsamuelTopic starter

  • Administrator
  • Trade Count: (0)
  • Duriel
  • **
  • Posts: 1766
  • Gender: Male
    • Snej-Mod Homepage
D2SE Modmanager [english/german]
« Reply #3 on: March 23, 2010, 02:36:56 pm »

D2SE Modmanager de-installation


It's pretty easy. Simply open the Windows Softwaremanager and uninstall the D2SE Modmanager.
Note that the glidewrapper and Plugy won't be uninstalled then, because they may be of use later.
If you want to remove them anyways, you have to delete them manually. Simply take a look at the file directory at the bottom of the installation post.

It may be that the D2SE directory incl. CORES-folder will not be deleted by the uninstallation. This means that you have one or several savefiles in your SAVE folders of the CORE folders.
Backup them if you wanna keep them, or delete the whole D2SE folder manually.

Once you installed at least one mod, the MODS folder will stay too. If you installed the modplugin via the installer, you have to uninstall it via the windows softwaremanager. The SAVE folder probably won't be uninstalled as well. Generally you can uninstall any mod by deleting the specific directory in the MODS folder, but if you installed a mod via installer, this will leave a blind entry in the windows softwaremanager.

« Last Edit: April 01, 2010, 01:15:12 am by Seltsamuel »

Offline SeltsamuelTopic starter

  • Administrator
  • Trade Count: (0)
  • Duriel
  • **
  • Posts: 1766
  • Gender: Male
    • Snej-Mod Homepage
D2SE Modmanager [english/german]
« Reply #4 on: March 23, 2010, 02:37:48 pm »

D2SE Modmanager for Modder




WIP work in progress!!!

D2SE Modmanager why should I use it as a Modder?

  • The Modmanager does the whole installation for you, including the support. Simply link to the Installinstructions of the common modplugins and you're done. As a modder you can concentrate on what you should .. and that's modding.

  • The Modmanager assures all players having the same patch and fileversions on which the mod is meant to be played.
    The installation is not an issue for the players anymore.

  • The mod (as a modplugin) is completely independant from the installed D2 version so you can mod the version which you like the most without having any harms or stressing your players with patches.

  • The mod as modplugin is like a closed island. All savegames, logs and screenshots are located IN the Modfolder.
    The mod doesn't have to care about anything outside the modfolder. On the other side, it's not its pidgin. This is an absolutely important issue which necessarily has to be maintained. A modplugin only CONTAINS the mod directory, NOTHING else.

  • The modmanager allows you to control several version of a mod in parallel, f.e. the current realm version, the version you just gave to the betatester and the one you are currently working at. The amount of possible plugins D2SE can handle is nearly infinite and only limited by the RAM.

  • it offers the players a lot of comfort and they dont have to do anything for it.

  • you have the possibility to let your players update your mod by just clicking a button on the Modmanager. (as far as you / your mod supports it)

  • All modplugins are protected from several bugs and incompatibilities with vanillaversions. The Modmanager is under active development so every single plugin also benefits from all bugfixea in the future.

  • There is no CD needed anymore for any modplugin, no matter which version. The modplugins also profit by enhanced errorchecks of the modmanager as well as by tests of integrity in the future.

  • The modmanager allows you to load 3 own .mpq files without any effort. All .mpq files have a higher priority than the patch_d2.mpq. Also, you can simply disable the original patch_d2.mpq so that it will not be loaded anymore.





D2SE Modmanager, how does this magic work?

That's what you will wonder, how should the Modmanager know that my Mod is there even though I may not do anything out of the mod's directory? The answer discloses a big secret: The "DS2SE_SETUP.ini" which has to be contained in every mods' directory causes that the mod will be found and be listed as a valid modplug-in in the Modmanager. This ONE file is the Modmanager's heart. By the way, it's the only interesting one for the Modmanager. There will be taken and saved all settings and user-settings individually. During this manual, I will exactly discribe this file as well as link a "DEFAULT" D2SE_SETUP.ini containing all possible options. You should use the linked file as basis for your own mod. By the way, the D2SE_SETUP.ini really is well documented, too.

At first, however, a detailed description of the starting process of D2SE.exe:
Start the Modmanager calling up the D2SE.exe and it will scan the ./D2SE/CORES to identify which Vanillaversions are available. Only the purely unmodified Corefiles may be there. Except me, anybody has no right to be there. Simply adding the additonal cores DOES NOT WORK. The Modmanager can only detect the ones contained in the CODE, so for the support of more cores, updating the Modmanagerwill be necessary. After the cores are detected, D2SE scans the ./MODS directory and detects there all sub-directories containing aD2SE_SETUP.ini. These will be loaded and evaluated because, among other things, there will be determined which modbanner should be shown.

IMPORTANT! If a player starts a mod, the modmanager knows from the D2SE_SETUP.ini which D2 version is necessary and which modsystems have to be initialized.



The D2SE_SETUP.ini, the heart of the system!

Quote
#This is for Modsystem compatibility only dont touch this!
[D2SE]
CreatedFor=2.1.0


Quote
#The User Checkboxes will be remembered here. All options can be altered inside GUI
[USERSETTINGS]
#Renderer 0=DDraw 1=D3D 2=not functional(openGL) 3=glide/3dfx default=3
Renderer=3
#WindowMode 0=Fullscreen 1=D2 inside Window (-w commandline) works only with glide+DDraw default=0
WindowMode=0

#NoSound 1=switch off sound (-ns commandline)
NoSound=0

#Enables Creation of HC Chars when ModAllowHC=1 default=1
EnableHC=1

#Enable PlugY when ModAllowPlugY=1
EnablePlugY=0

#Enable MultiRes when ModAllowMultiRes=1
EnableMultiRes=0

#Parameter for modding, only active when Modable=1
#Direct 1=use -direct commandline default=0
Direct=0
#Txt 1=use -txt commandline default=0
Txt=0
Quote
#Settings the Modder has to Set when using D2SE Modsystem it can be protected! Dont change anything here when its not your Mod and you want to play on Realm
[Protected]
#CoreEngine needed or included in this Mod all not included files will be taken from the Vanilla Folder of the Version!
#Supportet Cores are 1.07 1.08 1.09b 1.09d 1.10f 1.11b 1.12a 1.13c THIS MUST BE SET
D2Core=1.11b

#Modnames & Title 32 Chars each maximum
ModName=Snej
ModTitle=Diary of the Dark Wanderer

#Mod Versions 10 Chars each maximum
ModMajorVersion=6
ModMinorVersion=.0
ModRevision=.05

#Filename of a 250*60 Buttonimage in BMP format! keep the outer 1 pixel border black! used for Modselection
ModBanner=Snejbutton.bmp

#Button to launch readme can be file or Webpage
ModReadme=documentation\readme.htm
#Button to launch Descriptionfile can be file or Webpage
ModDescription=documentation\about.htm
#Button to reach Homepage can be file or Webpage
ModHP=http://snej.bananenblau.net/
#Button to reach Forum/Board can be file or Webpage
ModBoard=http://snej.d2maniacs.org/forum/

#Allow the activation of -direct and -txt switch default=0
Modable=0

#Allows the Creation of HC Characters default=1
ModAllowHC=1

#1=Allow Singleplayer Multistart!
ModAllowSPFeature=1

#ModSystems used
#Allowed with Core 1.11b: NEFEX
#Allowed with Core 1.10f: D2MOD
#Allowed with the Cores it was compiled for: D2Extra
#Allowed with all supportet Cores: D2SE
#for correct configuration and handling of nefex, d2mod and D2Extra refere to their readmes, ini files and documentation!
#for correct configuration and handling of D2SE refere to the documentation as soon as its available.
#not all features of each System can work together watch out for Collisions be warned!
#dont use any of their loadsystems D2SE will load the modsystems in a clean way for you!!!
#D2SE 1=load and init D2SE on startup
ModUseD2SE=1
#Name of the D2SE Mod dll 32 Chars maximum
D2SEDllName=SNEJ6005D2SE.dll
#D2SEUtility 1=use utility functions inside D2SEUtility.dll
ModUseD2SEUtility=0
#Nefex 1=load nefex at startup it does selfinitialization
ModUseNefex=0
#D2Mod 1=load and init D2Mod.dll at startup
ModUseD2Mod=0
#D2Extra 1=Use D2Extra on startup make sure you have the correct version for your D2 Core!
ModUseD2Extra=0

#PlugY 1=Allow PlugY make sure the installed Version supports the D2 Core! (1.09b 1.09d 1.10f 1.11b 1.12a)
ModAllowPlugY=0

#MultiRes 1=Allow Multires only allowed for 1.12a core
ModAllowMultiRes=0

#MPQ Setup
#1=Patch_D2.mpq gets loaded 0=gets unloaded. Use 0 only when your own .mpq holds all content of patch_d2.mpq
ModUsePatch_D2=1
#Names of up to 3 own MPQ Files in increasing priority. All of them are higher than patch_d2 #32 Chars each maximum
ModMPQ1=Snej_Mod.mpq
#ModMPQ2=DaylyQuests.mpq
#ModMPQ3=Snejpatch.mpq

#Realm setup DONT EVER USE D2SE to connect to official BNet. Checksum will fail for sure!
#Only use the baseinstallation of D2 patched to newest Patch to play on BNet with starting game.exe !!!
#Im not responsible if you are stupid! make sure you have no type errors this cannot get verified automatic!
RealmGateway=pvpgn.D2Maniacs.org
RealmTimezone=-1
RealmGatewayName=D2 Maniacs
RealmSelected=SnEj
RealmPort=4357

#UPDATE Setup
UpdateFile=Snej_UPD
UpdateMirror1=http://hosted.pulseone.at/~ultima/d2se/updates/
[END-Protected]

WIP !!!!!!!!!!!!!!!!
WIP !!!!!!!!!!!!!!!!
  • D2Core ->
  • ModName ->
    ModTitle ->
  • ModMajorVersion ->
    ModMinorVersion ->
    ModRevision ->
  • ModBanner ->
  • ModReadme ->
    ModDescription ->
    ModHP ->
    ModBoard ->
  • Modable= ->
  • ModAllowHC ->
WIP !!!!!!!!!!!!!!!!
WIP !!!!!!!!!!!!!!!!


Quote
#Her you can enable/disable and configure Features of the D2SEUtility.dll comming soon
[D2SEUTILITY]


Quote
#Read this from your own code for your own features!
[CUSTOM]



Quote
#dont touch this it must be at the end of file to check for corruptions
[END]
endoffile=4711



Einige wichtige Dinge zu beachten!
WIP hier wird gearbeitet!!!!!!!!!!!!!!!!
WIP hier wird gearbeitet!!!!!!!!!!!!!!!!



So stelle ich ein gutes Modplugin her!
WIP hier wird gearbeitet!!!!!!!!!!!!!!!!
WIP hier wird gearbeitet!!!!!!!!!!!!!!!!



[/quote]
« Last Edit: April 03, 2010, 01:18:04 am by Zerum »

Offline SeltsamuelTopic starter

  • Administrator
  • Trade Count: (0)
  • Duriel
  • **
  • Posts: 1766
  • Gender: Male
    • Snej-Mod Homepage
D2SE Modmanager [english/german]
« Reply #5 on: March 23, 2010, 02:49:33 pm »

DISCLAIMER



D2SE Modmanager ist Teil des D2SE Modsystems copyright 2008 von Seltsamuel.

Das Modsystem ist für Diablo II und dessen Erweiterung Lord of Destruction Copyright Blizzard Entertainment.

Der D2SE Modmanager enthält lediglich unmodifizierte dlls und Patchdateien von LOD die auf vielen Seiten frei verfügbar heruntergeladen werden können und dies mit Genehmigung von Blizzard. Ich beanspruche keinerlei Copyright für diese Dateien, da diese Eigentum von Blizzard Entertainment sind.

Die Grafiken der Benutzeroberfläche des Modmanagers sind Copyright von SamusAran.

Dieses Programm ist freie Software. Ich (Seltsamuel) erlaube hiermit die Benutzung, sowie den ORIGINALEN UNMODIFIZIERTEN Installer und die gesammte verfügbare Dokumentation, zu verlinken und weiterzuverbreiten unter folgenden BEDINGUNGEN:

  • Du must im Besitz einer gültigen Diablo II und LOD Lizenz sein. Ich unterstütze keine Softwarepiraterie.
    Besitzt Du keine gültige Lizenz gestatte ich die Benutzung von D2SE NICHT und das Programm ist SOFORT zu löschen.

  • Änderungen am D2SE Modmanager in jedweder Form sind NICHT erlaubt. D2SE ist freeware was nicht heißt das es kein Copyright besitzt.
    Der Sinn des Modmanagers ist es EINE einheitliche Plattform für alle Modder und Spieler zur Verfügung zu stellen, Versionsspaltungen und das verbreiten modifizierter Versionen verstößt gegen diesen Sinn. Wenn Du es erweitern möchtest oder Verbesserungsvorschläge hast setze Dich mit mir in Verbindung, D2SE mit all seinen Bestandteilen befindet sich in aktiver Entwicklung.

  • Für die Benutzung und Verbreitung des D2SE Modmanagers darf KEINERLEI Geld genommen werden.

  • Dieses Programm wird in der Hoffnung verbreitet nützlich zu sein, kommt jedoch ohne jegliche Garantie. Es besteht nichtmal die Garantie das es einen bestimmten Zweck erfüllt. Dieses Programm kommt "wie es ist", das Risiko der Benutzung obliegt allein dem Nutzer.



Ich habe versucht es frei und einfach für Euch zu halten, ich hoffe das mich niemand dazu zwingt restriktiver zu werden ;-)

Seltsamuel


« Last Edit: April 01, 2010, 01:43:10 am by Seltsamuel »

Offline SeltsamuelTopic starter

  • Administrator
  • Trade Count: (0)
  • Duriel
  • **
  • Posts: 1766
  • Gender: Male
    • Snej-Mod Homepage
D2SE Modmanager [english/german]
« Reply #6 on: March 23, 2010, 02:50:05 pm »

D2SE was ist das?


D2SE ist im Kern erstmal mein eigenes Modsystem was ursprünglich von mir für die Snej Mod erschaffen wurde. Da ich viele Vorteile für alle Spieler und Modder gesehen habe entschloss ich mich dieses System so umzugestalten und zu konzipieren, das nahezu alle D2Mods davon profitieren können.

D2SE besteht aus 2 Grundkomponenten:
1. Dem Modmanager welcher für Spieler und Modder gleichermaßen interessant ist.
2. Dem Code Modsystem welches hauptsächlich für die Modder gedacht ist.

Hier in diesem Abschnitt geht es jetzt erstmal um den Modmanager welcher released wird, das Codesystem wird irgendwann später folgen wenn es fertig ist. Damit es übersichtlicher ist habe ich die Anleitung für Spieler und Modder getrennt. Hier erstmal die Features die für alle interessant sind:

Der D2SE Modmanager erlaubt das parallele benutzen der D2 Versionen 1.07 1.08 1.09b 1.09d 1.10f 1.11b 1.12a und 1.13c UND nahezu aller Mods die auf diesen D2Versionen basieren. Die D2Versionen sind in der Grundinstallation von D2SE (knapp 13MB) bereits enthalten (im weiteren Verlauf als CORES benannt) und somit eine garantiert saubere und identische Basis für alle Mods und alle Spieler. Die einzelnen Mods sind NICHT enthalten und müssen separat installiert werden wie im entsprechenden Topic bei den Downloads beschrieben wird. Beim Mod/Versionswechsel werden KEINE Dateien kopiert oder verändert und die Mods müssen von den unveränderten Dateien NICHTS mitliefern sondern nur die rein gemoddeten Dateien was eine Distribution einfach und deutlich schlanker macht, nie wieder unnötiger Ballast in einer Mod sondern man kann sich auf das wesentliche konzentrieren.




D2SE unterstützt als Modsysteme: PlugY 9.0 (Cores 1.09b-1.12a), d2mod.dll (Core 1.10f nur!), nefex.dll (Core 1.11b nur!), D2Extra.dll (Cores für die es erstellt wurde) und natürlich das D2SE Codesystem sowie die vorab erscheinende D2SEUtility.dll (alle supporteten Cores!). D2SE erlaubt das laden von modifizierten D2 .DLL Dateien direkt aus dem Modordner, alle .DLL die dort nicht existieren werden aus den sauberen Core Ordnern der passenden Version geladen und zwar vollautomatisch. PlugY kann zusätzlich in der grafischen Oberfläche von D2SE individuell für jede Mod die es erlaubt per Checkbox an und ausgeschaltet werden.

D2SE gibt jeder Mod/Core ein eigenes "save" Verzeichnis für die Spielstände welches sich IM Mod/Core Verzeichnis befindet. Dies gilt auch für die PlugY shared Stash. Alle Logs und Screenshots werden ebenfalls IN das jeweilige Mod/Core Verzeichnis umgeleitet. Alles streng nach dem neuen Motto: alles was zu einer Mod gehört ist IM Modverzeichnis und nirgends sonst!

D2SE bietet allen D2Cores und Mods Schutz vor DEP (Windows Feature Dateiausführungsverhinderung) und fixt einen Fehler in Verbindung mit der AERO Windowsoberfläche von Win7 und Vista (durchlaufende Zahlen am Rand) Aero darf also an bleiben! Als Bonus wird der Mehrfache Start um mit sich selber im SP/MP zu mulen erlaubt (alle bis auf die 1. Instanz kommen NICHT auf Realm! Snejspieler kennen das SP Feature ja bereits) indem man einfach erneut D2SE.exe startet und dies sooft man mag!

D2SE benötigt KEINE CD im Laufwerk (gilt für alle Mods und Versionen!) und gibt Auskunft über Probleme mit der Installation (rotes/grünes CD Symbol) durch klicken auf das CD Symbol.

D2SE erlaubt eine komfortable Auswahl der zu spielenden Mod oder Coreversion in einer grafischen Benutzeroberfläche (GUI). Dort können viele Einstellungen vorgenommen werden die sich D2SE INDIVIDUELL für jede Mod und Coreversion separat MERKT. D2SE MERKT sich ebenfalls die zuletzt ausgewählte Mod/Core beim nächsten Start und durch einfaches drücken von "ENTER" oder Klick auf den "Start D2" Button wird die letzte Mod/Core mit den gemerkten Einstellungen gestartet. Will man eine Mod einfach schnell starten ohne die Einstellungen nochmal zu verändern kann man auch einen Doppelklick auf das Banner der jeweiligen Mod/Core machen um diese sofort zu starten. Der D2Vidtst sowie die Glide-init sind über Buttons direkt ansprechbar um in die Grafikeinstellungen zu gelangen, alle wichtigen Optionen sind DIREKT einstellbar.

D2SE bietet jeder Mod frei konfigurierbare Buttons welche mit Links auf "Readme" "About" "Homepage" "Forum" und "Configure Mod" belegt werden KÖNNEN. Desweiteren kann jede Mod bis zu 3 selbstbenannte eigene .mpq Dateien mit höherer Priorität als patch_d2 laden und wahlweise das laden letzterer abschalten, näheres dazu bei den Informationen für Modder.

D2SE setzt bei Mods mit Realmsupport automatisch den korrekten Realmserver als Gateway ein, ändert entsprechend den Realmport UND selektiert auch bereits die Realm korrekt in der Charauswahl vor... alles automatisch. Nie wieder Regfiles fummeln oder sich mit Regeditoren quälen oder gar vergessen die richtige Realm auszuwählen ^^.

D2SE wird bald sowohl sich selber als auch jede Mod die dies unterstützt per einfachem Klick auf den jeweiligen Update Button per AUTOUPDATER auf den neuesten Stand bringen können.


Generell muss man nur folgendes immer beachten:
- Will ich alle Vanillaversionen im SP/MP spielen oder alle Mods im SP/MP oder auf privater Realm -> starte ich D2SE.exe

- Will ich legal und unmodifiziert im offiziellen Bnet spielen -> starte ich die übliche game.exe
Man darf problemlos seine D2 Installation immer auf den neuesten Patch updaten auch wenn D2SE diesen NICHT kennt und darum nicht supportet, dies stört weder D2SE noch eine der Mods die man über D2SE starten kann. D2SE macht die Mods komplett unabhängig von Blizzards Patchmania und erlaubt trotz Modgenuss ein sorgenfreies spielen im Battlenet, dies natürlich über Blizzards game.exe!!


Nach dieser Featureauflistung gehts jetzt weiter zu einer ausführlichen Installationsanleitung im nächsten Post.
Modder und Technikfreaks können auch direkt zur Anleitung für Modder springen.
« Last Edit: August 07, 2011, 02:11:55 pm by Seltsamuel »

Offline SeltsamuelTopic starter

  • Administrator
  • Trade Count: (0)
  • Duriel
  • **
  • Posts: 1766
  • Gender: Male
    • Snej-Mod Homepage
D2SE Modmanager [english/german]
« Reply #7 on: March 23, 2010, 02:50:35 pm »

D2SE Modmanager Installation


Als Spieler muss man über die Arbeitsweise nicht viel wissen, man besorgt sich die -> D2SE_V2.2.0.exe <- und installiert diese über das mitgelieferte Setup durch einen Doppelklick auf die heruntergeladene Datei.


Den Begrüßungsbildschirm kann man mit einem Klick auf "Next" verlassen.


Im folgenden Bildschirm wird man nach dem Installationspfad des originalen D2 gefragt (der Hauptordner mit der game.exe und den großen .mpq Dateien drin!), der Installer gibt automatisch den richtigen Pfad an, wenn dieser bestimmt werden kann. Sollte der vorgegebene Pfad nicht stimmen dann muß man diesen manuell auswählen mithilfe des "Browse" Buttons. Mit einem Klick auf den "Next" Button bestätigt man den Pfad.


Hier wird man nach dem Ordnernamen der Verknüpfungen in der Startleiste gefragt die der Installer erstellen möchte, man kann die Vorgabe übernehmen, etwas eigenes auswählen oder aber mit der Checkbox bestätigen das man keine Verknüpfung in der Startleiste haben will. Wie üblich wird die Auswahl mit Klick auf "Next" bestätigt.


Dieser Bildschirm ermöglicht es zusätzliche Verknüpfungssymbole direkt auf dem Desktop und oder der Schnellstartleiste erstellen zu lassen. Die getroffene Auswahl wird wieder mit Klick auf "Next" bestätigt.


Die nun folgende Übersicht der gewählten Optionen kann man mit Klick auf "Install" bestätigen oder aber wenn man einen Fehler feststellt den in jedem Bildschirm vorhandenen "Back" Button anklicken um seine Auswahl zu korrigieren.


Nachdem der Installationsbalken durchgelaufen ist erreicht man den Abschlußbildschirm der einen von der erfolgreichen Installation in Kenntnis setzt. Zusätzlich kann man hier die Checkbox aktiviert lassen, die dafür sorgt, das beim Beenden des Installationsdialogs per Klick auf den "Finish" Button, der D2SE Modmanager gleich gestartet wird.


Herzlichen Glückwunsch der D2SE Modmanager ist nun einsatzbereit und alle unterstützten D2 Versionen sollten nun sofort auswählbar und spielbar sein. HIER gibt es eine ständig wachsende Liste mit Links zu Mods die D2SE kompatibel sind incl. Installationsanleitungen für diese.
D2SE kompatible Modmodule nenne ich im folgenden immer D2SE Modplugins. Wenn man selber eine Mod unter D2SE zum laufen bringen will sollte man sich die Anleitung für Modder im nächsten Post ansehen. Das Erstellen eigener D2SE Modplugins ist kinderleicht und beinhaltet lediglich das Anpassen einer einzigen Datei, der D2SE_SETUP.ini .. aber lest selber den folgenden Post falls es Euch interessiert, wenn nicht wünsche ich viel Spaß beim spielen der vielen D2 Versionen und bereits vorhandenen D2 Modplugins mit D2SE.


PS:
Damit man weiß was der Installer getan hat hier noch eine kurze Übersicht über die installierten Dateien, deren Bedeutung und die Filestruktur dahinter:

MYD2 steht in dieser Übersicht stellvertretend für das eigene D2 Verzeichnis was im Beispiel bei mir D:\Diablo II war.

MYD2\D2SE                      <- Dies ist der D2SE Systemordner er enthält alle wichtigen
                                  D2SE Hauptkomponenten. Generell gilt in diesem Ordner mit all
                                  seinen Unterordnern: FINGER WEG!!.
MYD2\D2SE\CORES                <- Hier befinden sich die sauberen D2 Versionen sprich deren
                                  .dll Dateien und deren patch_d2.mpq. Jede Version hat ihren Ordner
                                  und jeder dieser Ordner enthät ein eigenes SAVE Verzeichnis für
                                  Spielstände beim spielen der Vanilla Versionen. Bis auf die save
                                  Ordner gilt hier überall FINGER WEG!
MYD2\D2SE\UTEMP                <- Diesen Ordner benutzt der Autoupdater um Dateien aus dem
                                  Netz zu laden und zu entpacken FINGER WEG!

MYD2\D2SE\X_optional_X         <- Dieser Ordner ist interessant, da sich dort optionale Dateien
                                  befinden die man eventuell benutzen möchte. Zur Zeit befinden sich
                                  dort nur sogenannte .mpq Stubdateien, das sind mpq die nahezu leer
                                  sind und die man benutzen kann um die gleichnamigen mpq im
                                  D2 Hauptordner zu überschreiben. Dies bewirkt zwar das man auf
                                  Musik und Videos verzichten muss spart jedoch mehrere 100 MB an
                                  Festplatten Platz.
MYD2\D2SE\7zr.exe              <- Diese Datei gehört zu 7Zip einem packer/entpacker und wird
                                  vom Autoupdater zum entpacken der Updates benötigt. FINGER WEG!
MYD2\D2SE\Standard_Realm.reg   <- Sollte es beim verlassen von D2SE mal Probleme geben
                                  und die original D2 Realmgateways sollten nicht wiederhergestellt
                                  worden sein kann man diese per Doppelklick auf diese .reg wieder
                                  auf Standard zurücksetzen. Sollte niemals nötig sein,
                                  Datei liegt aber trotzdem hier ;-)

MYD2\MODS                      <- Dieser Ordner ist bei Installation bis auf eine Hinweisdatei
                                  noch leer, HIER sollen alle Modplugins hinein jede Mod in einem
                                  eigenen Verzeichnis. Dies ist der Bereich in dem sich die Modder
                                  austoben dürfen.
MYD2\PlugY                     <- Dies ist die Grundinstalation von PlugY 9.0 auch hier gilt
                                  FINGER WEG alle Mods die PlugY nutzen teilen sich diese Dateien.
                                  Die veränderten PlugY Dateien gehören IN die einzelnen Modordner
                                  hier NICHTS ÄNDERN!!!! Inhalt siehe Yohanns PlugY 9.0 ich spare
                                  mir die Auflistung hier ^^

Folgende 6 Dateien sind die EINZIGEN die D2SE in den D2 Ordner direkt installiert, dabei werden keine Originaldateien überschrieben und die Originalinstallation bleibt unberührt. Keines der D2SE Modplugins verändert irgend etwas ausserhalb des eigenen Pluginordners, dies ist Grundbedingung für alle D2SE Modplugins!!!
 
MYD2\D2SE.exe                  <- Dies ist das D2SE Hauptprogramm um D2SE zu benutzen muss
                                  man diese exe starten.
MYD2\D2SE.ini                  <- Dies ist die D2SE ini Datei hier merkt sich D2SE welche Mod
                                  zuletzt ausgewählt war.
MYD2\glide3x.dll               <- Die Hauptdatei von Sven Labuschs Glidewrapper.
MYD2\glide-init.exe            <- Das Konfigurationstool für den Glidewrapper,
                                  D2SE erlaubt das starten dieses Tools direkt von der grafischen Umgebung.
MYD2\glide-liesmich.txt        <- Dokumentation des Glidewrappers in deutsch.
MYD2\glide-readme.txt          <- Dokumentation des Glidewrappers in englisch.

Euer Seltsamuel
« Last Edit: August 07, 2011, 02:14:03 pm by Seltsamuel »

Offline SeltsamuelTopic starter

  • Administrator
  • Trade Count: (0)
  • Duriel
  • **
  • Posts: 1766
  • Gender: Male
    • Snej-Mod Homepage
Modmanager [english/german]
« Reply #8 on: March 23, 2010, 02:51:18 pm »

D2SE Modmanager De-Installation


Die Deinstallation ist ganz einfach, den Windowseigenen Softwaremanager aufrufen und D2SE Modmanager deinstallieren.
Zu beachten ist das der Glidewrapper und PlugY nicht mit deinstalliert werden da diese eventuell noch von Nutzen sind.
Will man diese trotzdem entfernen, dann im Installationspost die Filestruktur ganz unten ansehen und die angegebenen Dateien von Hand löschen.

Es kann sein, daß das D2SE Verzeichnis incl. CORES nicht automatisch gelöscht wird, dies ist dann der Fall, wenn sich in den CORE Unterverzeichnissen noch Spielstände in den SAVE Ordnern befinden. Diese dann sichern wenn man sie behalten will oder den gesammten D2SE Ordner incl. Unterverzeichnissen manuell löschen.

Sobald auch nur 1 Mod installiert wurde bleibt der MODS Ordner ebenfalls erhalten. Für diesen Ordner gilt, wurde das Modplugin per Installer installiert dieses über den Softwaremanager auch wieder entfernen, auch dort werden die SAVE ordner vermutlich nicht mit deinstalliert. Generell ist es so das man jede Mod deinstallieren kann indem man das Modverzeichnis aus MODS löscht, per Installer installierte Mods hinterlassen dann jedoch blinde Einträge im Windows Softwaremanager.

« Last Edit: April 01, 2010, 01:51:09 am by Seltsamuel »

Offline SeltsamuelTopic starter

  • Administrator
  • Trade Count: (0)
  • Duriel
  • **
  • Posts: 1766
  • Gender: Male
    • Snej-Mod Homepage
D2SE Modmanager [english/german]
« Reply #9 on: March 23, 2010, 02:51:43 pm »

D2SE Modmanager für Modder



D2SE Modmanager was bringt mir das als Modder?

  • Der Modmanager nimmt die gesamte Installation incl. Support ab, einfach auf die Installationanleitungen verlinken und man ist durch mit dem Thema. Als Modder kann man sich einzig auf das konzentrieren was man eigentlich machen sollte .. Modden.

  • Der Modmanager gewährleistet bei allen Spielern denselben Patch und Dateistand mit dem die Mod arbeitet.
    Die Installation beim Spieler ist kein unbekannter Faktor mehr.

  • Die Mod ist als Modplugin vollkommen unabhängig von der installierten D2 Version und man kann die Version Modden, die einem am meisten liegt, ohne dadurch Nachteile zu haben oder seine Spieler durch Patcharien zu belasten.

  • Die Mod als Modplugin ist eine abgeschlossene Insel, alle Savegames, Logs und Screenshots befinden sich IM Modverzeichnis,
    um alles ausserhalb des Modvezeichnisses muss sich die Mod nicht kümmern. Auf der anderen Seite geht die Mod jedoch auch alles ausserhalb des Modverzeichnisses nichts an. Dies ist ein absolut wichtiger Grundsatz der unbedingt eingehalten werden muß. Ein Modplugin ENTHÄLT nur das Modverzeichnis, NICHTS anderes.

  • Der Modmanager ermöglicht das parallele Betreiben mehrerer Versionen einer Mod z.b. der aktuellen Realmversion, der Version die man grade an die Betatester gegeben hat und der an der man grade aktuell am schrauben ist. Die Anzahl der möglichen Plugins die D2SE verwalten kann ist nahezu unendlich und nur durch Ram begrenzt.

  • Man gibt den Spielern einiges an Komfort ohne selber etwas dafür tun zu müssen.

  • Durch den Autoupdater wenn man ihn supportet hat man die Möglichkeit die Spieler per Knopfdruck updaten zu lassen.

  • Alle Modplugins werden vor einigen Bugs und vorhandenen inkompatibilitäten der Vanillaversionen geschützt, der Modmanager wird weiterentwickelt und jedes Plugin profitiert auch von zukünftigen Bugfixes.

  • Jedes Modplugin braucht standardmäßig keine CD mehr egal für welche Version und profitiert von erweiterten Fehlerabfragen des Modmanagers sowie auch von zukünftigen integritätstests. Jede Mod kann zudem wenn sie es erlaubt mehrfach gestartet werden .. so oft man will und es die resourcen zulassen.

  • Der Modmanager erlaubt ohne Aufwand das laden von bis zu 3 eigenen .mpq Dateien die allesamt eine höhere Priorität haben wie die patch_d2.mpq sowie das abschalten der originalen patch_d2.mpq so das diese nicht mehr geladen wird.




D2SE Modmanager, wie funktioniert diese Magie?
Das wird man sich sicher fragen, wie soll der Modmanager wissen das meine Mod da ist, wenn ich doch nichts ausserhalb meines Modverzeichnisses machen darf? Die Antwort darauf lüftet ein großes Geheimnis: Die D2SE_SETUP.ini die in jedem Modverzeichnis enthalten sein muss bewirkt das die Mod gefunden wird und als gültiges Modplugin im Modmanager gelistet wird. Diese EINE Datei ist das Herzstück des Modmanagers, übrigens die einzige die den Modmanager überhaupt interessiert. Alle Einstellungen der Mod werden dort vorgenommen und alle Benutzereinstellungen werden dort individuell gespeichert. Im Verlauf dieser Anleitung werde ich diese Datei genau beschreiben sowie eine "DEFAULT"  D2SE_SETUP.ini verlinken die man als Basis für seine eigene Mod nehmen sollte und welche alle Optionen die möglich sind enthält. Die D2SE_SETUP.ini ist übrigens auch recht ausführlich dokumentiert.

Der D2SE.exe Startvorgang:
Startet man den Modmanager indem man die D2SE.exe aufruft führt dieser als erstes einen Scan von ./D2SE/CORES durch um festzustellen welche Vanillaversionen alle verfügbar sind. In diesem Verzeichnis dürfen nur die rein unmodifizierten Coredateien liegen und niemand ausser mir hat eigentlich dort was zu suchen. Ein einfaches hinzufügen von zusätzlichen Cores dort FUNKTIONIERT NICHT der Modmanager kann nur die erkennen die auch im CODE enthalten sind sprich support von mehr Cores erfordert ein update des Modmanagers. Nachdem die Cores erkannt wurden Scannt D2SE das ./MODS Verzeichnis und erkennt dort alle Unterverzeichnisse welche eine D2SE_SETUP.ini enthalten. Diese werden sofort geladen und ausgewertet da dort unter anderem festgelegt wird welches Modbanner angezeigt werden soll.

WICHTIG ZU WISSEN! Startet der Spieler nun eine Mod weiß der Modmanager aus der D2SE_SETUP.ini welche D2 Version diese Mod benötigt und welche Modsysteme initialisiert werden müssen. Nun lädt der Modmanager die D2 .dll Dateien und zwar IN FOLGENDER REIHENFOLGE!! Findet er eine .dll Datei IM Modordner lädt er diese, wenn nicht sucht er im jeweiligen CORE Verzeichnis der zugehörigen Modversion nach der .dll findet er diese dort auch nicht kommt es drauf an, ist es eine .dll die sich zwischen den Versionen nie geändert hat (z.b. SmackW32.dll) lädt er diese aus dem D2 Hauptverzeichnis wenn nicht gibt es eine Fehlermeldung das die .dll nicht geladen werden konnte. Besitzt die Mod also editierte .dll Dateien (meistens d2client d2common und d2game) müssen diese IN das eigene Modverzeichnis, jedoch NUR diese editierten, es macht keinen Sinn die Standard .dll dort hinzulegen, da diese nur unnötig Platz verschwenden und genausogut aus dem CORE Ordner gelesen werden können. Bitte also merken Ladereihenfolge der D2 .dll Dateien ist MODORDNER->COREORDNER->D2ORDNER.

Nach dem laden der .dll Dateien lädt der Modmanager die .mpq Dateien, auch jene die man zusätzlich in der D2SE_SETUP.ini angeben kann. Danach initialisiert der Modmanager die Modsysteme, dies tut er SELBER, etwaige eigene Lader der Systeme (Plugy Nefex D2Mod) SIND ZU ENTFERNEN! (meist in d2win.dll oder d2gfx.dll zum teil jedoch auch in den PlugY oder d2mod .ini files!!). Dies bezieht sich rein auf die Hauptlader der Systeme selber! Ist dies alles abgeschlossen wird der gameloop aktiviert und das Spiel beginnt mit dem Intro/Mainmenu. Da wir nun das Arbeitsprinzip verstanden haben können wir uns im folgenden Abschnitt das Herz des Modmanagers ganz genau betrachten.



Die D2SE_SETUP.ini, das Herz des Systems!
Der erste Teil der .ini Datei ist Systemintern um zu gewährleisten das spätere Versionen des Modmanagers mit den .ini Dateien kompatibel bleiben.
Dort wird vermerkt für welche Modmanager Version die .ini geschrieben wurde.
Quote
#This is for Modsystem compatibility only dont touch this!
[D2SE]
CreatedFor=2.1.0


In den Usersettings speichert der Modmanager die aktuellen Einstellungen aus der grafischen Oberfläche. Beim starten des Modmanagers werden diese ausgelesen und die checkboxen entsprechend gesetzt.
Quote
#The User Checkboxes will be remembered here. All options can be altered inside GUI
[USERSETTINGS]
#Renderer 0=DDraw 1=D3D 2=not functional(openGL) 3=glide/3dfx default=3
Renderer=3
#WindowMode 0=Fullscreen 1=D2 inside Window (-w commandline) works only with glide+DDraw default=0
WindowMode=0

#NoSound 1=switch off sound (-ns commandline)
NoSound=0

#Enables Creation of HC Chars when ModAllowHC=1 default=1
EnableHC=1

#Enable PlugY when ModAllowPlugY=1
EnablePlugY=0

#Enable MultiRes when ModAllowMultiRes=1
EnableMultiRes=0

#Parameter for modding, only active when Modable=1
#Direct 1=use -direct commandline default=0
Direct=0
#Txt 1=use -txt commandline default=0
Txt=0
  • Renderer -> Hier wird der aktuell ausgewählte Videomode gespeichert, Optionen sind 0=DDraw 1=D3D und 3=GLIDEWRAPPER ->DEFAULT 3.
    2 war von Blizzard für native openGL Unterstützung vorgesehen aber wurde dann niemals auf dem PC realisiert. In einer späteren Version des Modmanagers kann der Modder mit der "ModDisplaymask" in der [PROTECTED]  Sektion die Auswahlmöglichkeiten zusätzlich einschränken.
  • WindowMode -> Hier wird gespeichert ob im Fenstermodus gestartet werden soll oder nicht 1=Fenstermodus (-w Parameter) 0=Vollbild -> DEFAULT 0. Als besonderheit stellt diese Checkbox gleichzeitig den Glidewrapper auf Fenstermodus um damit man sich einen unnötigen gang ins glide-init sparen kann. Windowmode ist nur bei DDraw und Glide erlaubt die D3D implementierung sieht nur Vollbild vor.
  • NoSound -> Diese Option kann die Werte 1=nosound (-ns Parameter) und 0=sound enthalten -> DEFAULT 0
  • EnableHC -> Erstellen von Hardcorechars erlaubt? 0=nein 1=ja -> DEFAULT 1
    Der Modder kann dies in der [Protected] Sektion mit der Option "ModAllowHC" sperren.
  • EnablePlugY -> PlugY aktiviert 0=nein 1=ja ->DEFAULT 0
    Der Modder kann dies in der [Protected] Sektion mit der Option "ModAllowPlugY" sperren.
  • EnableMultiRes -> Multires aktiv 1=ja 0=nein -> DEFAULT 0
    Der Modder kann dies in der [Protected] Sektion mit der Option "ModAllowMultiRes" sperren.
    ACHTUNG!! Diese Option ist deaktiviert, es ist mir nicht gelungen Multires stabil in D2SE einzubinden, ich werde bei Gelegenheit ein eigenes
    Tool zum erhöhen der Auflösung zur Verfügung stellen .. dies kann aber noch dauern.
  • Direct -> -direct Parameter aktiviert das Laden von Dateien aus dem DATA Ordner des Modordners 1=aktiv 0=normalstart -> DEFAULT=0
    Der Modder kann dies in der [Protected] Sektion mit der Option "Modable" sperren. Ist es gesperrt gibt es in der GUI die Checkboxen nicht!
  • Txt -> -txt Parameter aktiviert das compilieren vorhandener .txt files beim start von D2 1=aktiv 0=normalstart -> DEFAULT=0
    Der Modder kann dies in der [Protected] Sektion mit der Option "Modable" sperren. Ist es gesperrt gibt es in der GUI die Checkboxen nicht!


Die [PROTECTED] Sektion ist die wichtigste Sektion der D2SE_SETUP.ini, alle anderen bis auf den Header und das Prüffeld am Ende müssten nichteinmal existieren. Hier werden alle lebenswichtigsten Einstellungen vorgenommen und wenn der Modder das D2SE Modsystem benutzt kann er diesen gesammten Bereich durch eine Prüfsumme vor unbefugten Änderungen absichern. Hier befindet sich der einzige Eintrag der unbedingt gebraucht wird und das ist der "D2Core" Eintrag.
Quote
#Settings the Modder has to Set when using D2SE Modsystem it can be protected! Dont change anything here when its not your Mod and you want to play on Realm
[Protected]
#CoreEngine needed or included in this Mod all not included files will be taken from the Vanilla Folder of the Version!
#Supportet Cores are 1.07 1.08 1.09b 1.09d 1.10f 1.11b 1.12a 1.13c THIS MUST BE SET
D2Core=1.11b

#Modnames & Title 32 Chars each maximum
ModName=Snej
ModTitle=Diary of the Dark Wanderer

#Mod Versions 10 Chars each maximum
ModMajorVersion=6
ModMinorVersion=.0
ModRevision=.05

#Filename of a 250*60 Buttonimage in BMP format! keep the outer 1 pixel border black! used for Modselection
ModBanner=Snejbutton.bmp

#Button to launch readme can be file or Webpage
ModReadme=documentation\readme.htm
#Button to launch Descriptionfile can be file or Webpage
ModDescription=documentation\about.htm
#Button to reach Homepage can be file or Webpage
ModHP=http://snej.bananenblau.net/
#Button to reach Forum/Board can be file or Webpage
ModBoard=http://snej.d2maniacs.org/forum/

#Allow the activation of -direct and -txt switch default=0
Modable=0

#Allows the Creation of HC Characters default=1
ModAllowHC=1

#1=Allow Singleplayer Multistart!
ModAllowSPFeature=1

#ModSystems used
#Allowed with Core 1.11b: NEFEX
#Allowed with Core 1.10f: D2MOD
#Allowed with the Cores it was compiled for: D2Extra
#Allowed with all supportet Cores: D2SE
#for correct configuration and handling of nefex, d2mod and D2Extra refere to their readmes, ini files and documentation!
#for correct configuration and handling of D2SE refere to the documentation as soon as its available.
#not all features of each System can work together watch out for Collisions be warned!
#dont use any of their loadsystems D2SE will load the modsystems in a clean way for you!!!
#D2SE 1=load and init D2SE on startup
ModUseD2SE=1
#Name of the D2SE Mod dll 32 Chars maximum
D2SEDllName=SNEJ6005D2SE.dll
#D2SEUtility 1=use utility functions inside D2SEUtility.dll
ModUseD2SEUtility=0
#Nefex 1=load nefex at startup it does selfinitialization
ModUseNefex=0
#D2Mod 1=load and init D2Mod.dll at startup
ModUseD2Mod=0
#D2Extra 1=Use D2Extra on startup make sure you have the correct version for your D2 Core!
ModUseD2Extra=0

#PlugY 1=Allow PlugY make sure the installed Version supports the D2 Core! (1.09b 1.09d 1.10f 1.11b 1.12a)
ModAllowPlugY=0

#MultiRes 1=Allow Multires only allowed for 1.12a core
ModAllowMultiRes=0

#MPQ Setup
#1=Patch_D2.mpq gets loaded 0=gets unloaded. Use 0 only when your own .mpq holds all content of patch_d2.mpq
ModUsePatch_D2=1
#Names of up to 3 own MPQ Files in increasing priority. All of them are higher than patch_d2 #32 Chars each maximum
ModMPQ1=Snej_Mod.mpq
#ModMPQ2=DaylyQuests.mpq
#ModMPQ3=Snejpatch.mpq

#Realm setup DONT EVER USE D2SE to connect to official BNet. Checksum will fail for sure!
#Only use the baseinstallation of D2 patched to newest Patch to play on BNet with starting game.exe !!!
#Im not responsible if you are stupid! make sure you have no type errors this cannot get verified automatic!
RealmGateway=pvpgn.D2Maniacs.org
RealmTimezone=-1
RealmGatewayName=D2 Maniacs
RealmSelected=SnEj
RealmPort=4357

#UPDATE Setup
UpdateFile=Snej_UPD
UpdateMirror1=http://hosted.pulseone.at/~ultima/d2se/updates/
[END-Protected]

WIP hier wird gearbeitet!!!!!!!!!!!!!!!!
WIP hier wird gearbeitet!!!!!!!!!!!!!!!!
  • D2Core ->
  • ModName ->
    ModTitle ->
  • ModMajorVersion ->
    ModMinorVersion ->
    ModRevision ->
  • ModBanner ->
  • ModReadme ->
    ModDescription ->
    ModHP ->
    ModBoard ->
  • Modable= ->
  • ModAllowHC ->
WIP hier wird gearbeitet!!!!!!!!!!!!!!!!
WIP hier wird gearbeitet!!!!!!!!!!!!!!!!

Dieses Segment wird für Einstellungen und Optionen der kommenden D2SEUtility.dll benutzt, dieses Utility wird eine Mischung aus PlugY D2Mod und Nefex, jedoch um einiges mächtiger und präzise hier konfigurierbar.
Quote
#Her you can enable/disable and configure Features of the D2SEUtility.dll comming soon
[D2SEUTILITY]

Modder die eigenen Code benutzen können dieses Segment der D2SE_SETUP.ini mitbenutzen und hier ihre eigenen Einstellungen ablegen und abfragen. Der Modmanager startet die Mod immer mit dem aktuellen Pfad ins Modverzeichnis verlegt, so das diese ini immer ohne Pfadangabe zu erreichen ist.
Quote
#Read this from your own code for your own features!
[CUSTOM]


Die .ini Datei muss immer hiermit enden. Der Modmanager nutzt dies um zu überprüfen ob die Datei vollständig geladen wurde, denn gab es Übertragungsfehler z.b. vom Autoupdater kann das Ende der Datei ja nicht da sein.
Quote
#dont touch this it must be at the end of file to check for corruptions
[END]
endoffile=4711



Einige wichtige Dinge zu beachten!
WIP hier wird gearbeitet!!!!!!!!!!!!!!!!
WIP hier wird gearbeitet!!!!!!!!!!!!!!!!



So stelle ich ein gutes Modplugin her!
WIP hier wird gearbeitet!!!!!!!!!!!!!!!!
WIP hier wird gearbeitet!!!!!!!!!!!!!!!!


« Last Edit: January 08, 2011, 05:36:52 pm by Seltsamuel »

Snejportal  |  D2SE  |  D2SE Modmanager  |  Topic: D2SE Modmanager [english/german]
 

gfxgfx
gfx
Powered by SMF 2.0 RC4 | SMF © 2006–2010, Simple Machines LLC  Snejtheme V2 by Seltsamuel/Faust (based on Helios Multi by Bloc)
gfx