
MISI
build v0.4.2, 1 may 2018 by DenLover
MD5 ce9555ae13ba1f206b93c183e5b15133 MISI.ASI


License:

This MISI library (hereinafter "application") is distributed by
license (Public Domain) free software "as is"
without any guarantees.

This application (hereinafter "Project") is
public domain of the GTAMP community.
All source codes, logos, texts, project names are open,
are the combined work of people united by a common idea and a dream.

Everyone can use this project without restrictions
at its discretion:
Compile, modify, correct, supplement, update, sell,
distribute under its own brand and mark.


Thank you:

Thank authors and their resources:

Sector for maintaining the game
GTA2 community thanks to him and his comrades people do not forget
about this beautiful game. Also for the useful
Addresses and methods for working with the memory of the game.
http://www.gtamp.com

Vike for patches for the game. Also for the maintenance of the GTA2 community.
http://gtamp.com/forum/viewtopic.php?f=4&t=73

robotanarchy for found and described useful addresses.
https://github.com/Bytewerk/gta2-hackers-remix

Jones for the memory addresses found and published by them.
http://gtamp.com/forum/viewtopic.php?f=4&t=700&start=20#p9357

BeepBoop for found and described useful addresses.
http://gtamp.com/forum/viewtopic.php?f=4&t=1123

Jernej for useful programs
thanks to which I started studying modemaking in GTA2.
http://www.gtatools.com

BenMillard for contribution to the development of modding in GTA2.
For writing tutorials
http://projectcerbera.com

Also thank all people who have published useful
materials and took part in discussions with me at 
http://www.gtamp.com

Dark Byte for useful programs
http://www.cheatengine.org

Take-Two Interactive for the creation of a wonderful game GTA2
https://www.take2games.com

Library LUA http://www.lua.org

Inno Setup http://www.jrsoftware.org

Examples of https://www.stackoverflow.com


Contributers:

People who made an active contribution to the development of the project.

Sector
The useful address is http://gtamp.com/forum/viewtopic.php?f=4&t=1124#p10549 
This address allowed to create a "Stage Constructor"
in which you can dynamically create/delete game objects.

Also, the Sector made a great contribution to the very possibility of creating a library,
placing openly found them memory addresses in the subject.
These addresses were used to create MISI
http://gtamp.com/forum/viewtopic.php?f=4&t=700#p8337

BeepBop
Found and provided a useful address
http://gtamp.com/forum/viewtopic.php?f=4&t=700&start=60#p10564

Also in this topic were published addresses that were also used in MISI
http://gtamp.com/forum/viewtopic.php?f=4&t=1123#p10326

elypter
For the activity in the project theme
http://gtamp.com/forum/viewtopic.php?f=4&t=1136#p10511

DenLover
Idea, programming, logo, documentation
Email: logofero@gmail.com

Dege
The author who created the first mod "Alternative Control Scheme" based on MISI
http://gtamp.com/forum/viewtopic.php?f=4&t=1136&p=10691#p10681


Installation:

* Requires the installed game GTA2 v11.44

1. Run the installer misi_setup.exe
2. Select the installer language
3. Read and accept the license agreement
4. Select the root directory of the game
5. Select components to install
6. Confirm the installation
7. Installation complete


Error processing:

When you first start MISI creates a log file
MISI.log in the root where it keeps its state
(booted, unloaded). Also in the log will be displayed
errors from LUA scripts. The error description will be
path to the script, line number and reason.

If your game
will fly out but in the log will be clean, try to transfer
All your scripts from the scripts folder and check them one at a time.
If the game drops again but there are no entries in the log, try
Run the game without scripts, to avoid the fall due to
MISI.ASI move or delete the library from the root of the game.


What is it?

Library for running LUA scripts in GTA2.
The library is loaded at the start of the game and gives you access
to the game world (as much as the author knows
useful addresses in the memory of the game).

The name MISI came to
me from the derived word of the initial scripts * .MIS
(which in translation probably means a mission) and together with
extension ASI (which is used in the game) it turned out
quite in tune with MISI.ASI.


What is this for?

For easy and
quick creation/editing of game missions, trainers.
Thanks to the simple LUA syntax, anyone can use it
To study and write the unpretentious script for GTA2 without spending
thus it is a lot of time. It is enough to install MISI in the game,
create a text * .TXT or * .LUA file (name it as
wish), throw in the root folder script located
in the root directory of the game (where gta2.exe is located),
After that, you can run the game and enjoy your
creation.


Is it safe?

As much as you are willing to
to see danger for example: "seeing a shadow of its own owl".

Library
acts as a driver for translating commands from user
LUA scripts in the memory of the game. If scripts are not written correctly
the maximum that can happen is the crash of the game, if this happens
bug your script in the script folder after that
once again start the game. To restore the normal state
games simply delete all files from the script folder in the GTA2 directory.


How to find out the reason for the departure/error?

By default, MISI creates
log at the root of the game MISI.log it displays all the main errors
during the library download. There you can also read errors
scripts pointing to the lines of code. In order not to slow down
system weak PC log will be automatically overwritten
when the volume reaches more than 2 MB (it is by default).
The maximum permissible size
SetLogSize (size) is 1GB.


Where can I find the API for MISI?

All the documentation on MISI you can find in a separate file
inside the archive under the name DOCEN. The documentation will be
opportunities, and the need to be complemented by new features.

To learn the LUA API, I advise you to visit the official website
its developers. In the MISI library, you use
version LUA 5.3.4 Reference to the official documentation for
all basic modules https://www.lua.org/manual/5.3


What are the limits?

The MISI bibliography supports multithreading.
Each file is a separate thread. You can simultaneously
download 2000 scripts. It's important to remember that every script
An infinite cycle in the base is a decrease in the total
productivity is recommended (with a notable
slowdown start load) use delay wait
 in the body of the loop:

while(true) do
	wait(200)
end

As much less will reduce
performance scripts that are unloaded immediately
after execution. Try not to add to the game a lot
number of scripts with infinite loops otherwise this may
lead to a slowdown of the entire system.


What version of the game do you need?

Current build MISI v0.4.2, 1 may 2018
will work with the version of the game v11.44.


Where can I see the change history?

In the CHANGES file
in the archive with this library.
