fallout2sfall/sfall
0
0
Fork 0
mirror of https://github.com/sfall-team/sfall.git synced 2026-07-27 16:52:34 -07:00
Code Issues Packages Projects Releases Wiki Activity

Deprecated two-argument form of add_extra_msg_file

Browse Source 
Edits to scripting documents.
This commit is contained in:
NovaRain
2026-03-26 12:09:32 +08:00
parent 7b3f69f496
commit c28d8c0d2b
5 changed files with 28 additions and 31 deletions
Download Patch File Download Diff File Expand all files Collapse all files
artifacts/scripting/functions.yml
+9 -9
View File
@@ -565,7 +565,7 @@
doc: |
Used to play `mp3/wav/wma` files. The path given is relative to the Fallout folder. Specify mode as 1 to loop the file continuously, 2 to replace the current background game music with playing the specified file in loop mode, or 0 to play the file once. If you don't wish to loop, `play_sfall_sound` returns 0. If you do loop, it returns an ID which can be passed back to `stop_sfall_sound` when you want to stop the effect. All sounds effects will be stopped on game reload, looping or not. Does not require `AllowDShowSound` to be set to 1 in `ddraw.ini`.
Starting from sfall 4.2.8/3.8.28, you can pass a value in the `mode` argument for a reduced sound volume. To set the volume, you need to convert the number to hexadecimal and use the argument format `0xZZZZ000Y`, where `ZZZZ` is the volume reduction value in range from 0 to 32767 (the value 32767 is mute), and `Y` is the playback mode.
Starting from sfall 4.2.8/3.8.28, you can pass a value in the `mode` argument for a reduced sound volume. To set the volume, you need to convert the number to hexadecimal and use the argument format `0xZZZZ000Y`, where `ZZZZ` is the volume reduction value in the range of 0 to 32767 (the value 32767 is mute), and `Y` is the playback mode.
- name: stop_sfall_sound
detail: void stop_sfall_sound(int soundID)
opcode: 0x822c
@@ -848,7 +848,7 @@
opcode: 0x824b
- name: tile_light
detail: int tile_light(int elevation, int tileNum)
doc: Returns light intensity at the given tile in range from 0 to 65535.
doc: Returns light intensity at the given tile in the range of 0 to 65536.
opcode: 0x826d
- name: tile_get_objs
detail: array tile_get_objs(int tileNum, int elevation)
@@ -926,11 +926,11 @@
- name: set_pickpocket_max
detail: void set_pickpocket_max(int percentage)
opcode: 0x81a0
doc: Effects all critters rather than just the player and can set the maximum in range from 0 to 999.
doc: Effects all critters rather than just the player and can set the maximum in the range of 0 to 999.
- name: set_hit_chance_max
detail: void set_hit_chance_max(int percentage)
opcode: 0x81a1
doc: Effects all critters rather than just the player and can set the maximum in range from 0 to 999.
doc: Effects all critters rather than just the player and can set the maximum in the range of 0 to 999.
- name: set_xp_mod
detail: void set_xp_mod(int percentage)
opcode: 0x81aa
@@ -1010,7 +1010,7 @@
- name: get_light_level
detail: int get_light_level
opcode: 0x8226
doc: Returns ambient light level in range 0..65536. The value returned by get_light_level may not exactly match that set by `set_light_level`, as `set_light_level` applies modifiers from the Night Vision perk.
doc: Returns ambient light level in the range of 0 to 65536. The value returned by get_light_level may not exactly match that set by `set_light_level`, as `set_light_level` applies modifiers from the Night Vision perk.
- name: mark_movie_played
detail: void mark_movie_played(int id)
@@ -1483,12 +1483,12 @@
- name: add_extra_msg_file
detail: int add_extra_msg_file(string fileName)
doc: |
Loads the custom message file, and returns the file ID number assigned to it in range from 0x3000 to 0x3FFF for the `message_str_game` function to get messages from the file.
Loads a custom message file and returns the file ID number assigned to it, in the range of 0x3000 to 0x3FFF, for use with the `message_str_game` function.
- `fileName`: the name of the custom message file (including the .msg extension) in `text\<language>\game\` directory.
- __NOTE:__ if the msg file does not exist in the current language directory, the function will try to load it from the `text\English\game\` directory.
Alternative form: `int add_extra_msg_file(string fileName, int fileNumber)`
- `fileNumber`: the file ID number for the `message_str_game` function. The available range is from 0x2000 to 0x2FFF (see `ExtraGameMsgFileList` setting in `ddraw.ini`)
Use `fileNumber` only if you want to add a message file without editing `ddraw.ini` or existing scripts to support the old way.
Alternative form: `int add_extra_msg_file(string fileName, int fileNumber)` **[DEPRECATED]**
- __Deprecation notice:__ Starting from sfall 4.4.10/3.8.50, the two-argument form is deprecated. The `fileNumber` argument is ignored, and the function behaves the same as the one-argument form.
macro: sfall.h
- name: void sfall_func0("remove_timer_event")
artifacts/scripting/sfall function notes.md
+7 -9
View File
@@ -41,7 +41,7 @@ The **type** value in the weapon knockback functions can be 0 or 1. If 0, the va
The `get_sfall_global` and `set_sfall_global` functions require an 8 characters long case sensitive string for the variable name. The variables behave the same as normal Fallout globals, except that they don't have to be declared beforehand in **vault13.gam**. Trying to get a variable which hasn't been set will always return 0. These functions are intended for use when a patch to a mod requires the addition of a new global variable, a case which would otherwise require the player to start a new game.
The `set_pickpocket_max` and `set_hit_chance_max` affect all critters rather than just the player and can set the maximum in range from 0 to 999.
The `set_pickpocket_max` and `set_hit_chance_max` affect all critters rather than just the player and can set the maximum in the range of 0 to 999.
The `set_skill_max` can't be used to increase the skill cap above 300. The `set_perk_level_mod` sets a modifier between +25 and -25 that is added/subtracted from the player's level for the purposes of deciding which perks can be chosen.
@@ -66,7 +66,7 @@ The `get_proto_data` and `set_proto_data` are used to manipulate the in memory c
The `list_xxx` functions can be used to loop over all items on a map. `list_begin` takes an argument telling sfall what you want to list (defined in **sfall.h**). It returns a list pointer, which you iterate through with `list_next`. Finally, when you've finished with the list use `list_end` on it. Not calling `list_end` will result in a memory leak. Alternatively, use `list_as_array` to get the whole list at once as a temp array variable, which can be looped over using `len_array` and which you don't need to remember to free afterwards.
The `play_sfall_sound` and `stop_sfall_sound` are used to play **mp3/wav/wma** files. The path given is relative to the Fallout folder. Specify mode as 1 to loop the file continuously, 2 to replace the current background game music with playing the specified file in loop mode, or 0 to play the file once. If you don't wish to loop, `play_sfall_sound` returns 0. If you do loop, it returns an ID which can be passed back to `stop_sfall_sound` when you want to stop the effect. All sounds effects will be stopped on game reload, looping or not. These functions do not require **AllowDShowSound** to be set to 1 in **ddraw.ini**.
Starting from sfall 4.2.8/3.8.28, you can pass a value in the **mode** argument for a reduced sound volume. To set the volume, you need to convert the number to hexadecimal and use the argument format `0xZZZZ000Y`, where `ZZZZ` is the volume reduction value in range from 0 to 32767 (the value 32767 is muted), and `Y` is the playback mode.
Starting from sfall 4.2.8/3.8.28, you can pass a value in the **mode** argument for a reduced sound volume. To set the volume, you need to convert the number to hexadecimal and use the argument format `0xZZZZ000Y`, where `ZZZZ` is the volume reduction value in the range of 0 to 32767 (the value 32767 is mute), and `Y` is the playback mode.
Arrays are created and manipulated with the `xxx_array` functions. An array must first be created with `create_array` or `temp_array`, specifying how many data elements the array can hold. You can store any of ints, floats and strings in an array, and can mix all 3 in a single array. The ID returned by `create_array` or `temp_array` can then be used with the other array functions. Arrays are shared between all scripts. (i.e. you can call `create_array` from one script, and then use the returned ID from another script.) They are also saved across savegames. Arrays created with `temp_array` will be automatically freed at the end of the frame. These functions are safe, in that supplying a bad ID or trying to access out of range elements will not crash the script. `create_array` is the only function that returns a permanent array, all other functions which return arrays (`string_split`, `list_as_array`, etc,) all return temp arrays. You can use `fix_array` to make a temp array permanent.\
__NOTE:__ refer to **arrays.md** for detailed description of the array behavior and function usage.
@@ -172,7 +172,7 @@ FUNCTION REFERENCE
-----
#### `int get_light_level`
- Ambient light level in range 0..65536
- Returns ambient light level in the range of 0 to 65536.
- The value returned by `get_light_level` may not exactly match that set by `set_light_level`, as `set_light_level` applies modifiers from the night vision perk.
-----
@@ -439,7 +439,7 @@ FUNCTION REFERENCE
-----
#### `int tile_light(int elevation, int tileNum)`
- Returns light intensity at the given tile in range from 0 to 65536.
- Returns light intensity at the given tile in the range of 0 to 65536.
-----
#### `object obj_blocking_line(object objFrom, int tileTo, int blockingType)`
@@ -858,13 +858,11 @@ sfall_funcX metarule functions
----
#### add_extra_msg_file
`int sfall_func1("add_extra_msg_file", string fileName)`\
`int sfall_func2("add_extra_msg_file", string fileName, int fileNumber)`
- Loads the custom message file, and returns the file ID number assigned to it in range from `0x3000` to `0x3FFF` for the `message_str_game` function to get messages from the file
`int sfall_func2("add_extra_msg_file", string fileName, int fileNumber)` **[DEPRECATED]**
- Loads a custom message file and returns the file ID number assigned to it, in the range of `0x3000` to `0x3FFF`, for use with the `message_str_game` function
- `fileName`: the name of the custom message file (including the **.msg** extension) in the `text\<language>\game\` directory
- __NOTE:__ if the msg file does not exist in the current language directory, the function will try to load it from the `text\English\game\` directory
**Optional argument:**
- `fileNumber`: the file ID number for the `message_str_game` function. The available range is from `0x2000` to `0x2FFF` (see **ExtraGameMsgFileList** setting in **ddraw.ini**). Use **fileNumber** only if you want to add a message file without editing **ddraw.ini** or existing scripts to support the old way
- __Deprecation notice:__ Starting from sfall 4.4.10/3.8.50, the two-argument form is deprecated. The `fileNumber` argument is ignored, and the function behaves the same as the one-argument form.
----
#### unwield_slot
sfall/Modules/Message.cpp
+3 -8
View File
@@ -254,13 +254,8 @@ static void ReadExtraGameMsgFiles() {
}
}
long Message::AddExtraMsgFile(const char* msgName, long msgNumber) {
if (msgNumber) {
if (msgNumber < 0x2000 || msgNumber > 0x2FFF) return -1;
if (Message::gExtraGameMsgLists.find(msgNumber) != Message::gExtraGameMsgLists.cend()) {
return 0; // file has already been added
}
} else if (msgNumCounter > 0x3FFF) return -3;
long Message::AddExtraMsgFile(const char* msgName) {
if (msgNumCounter > 0x3FFF) return -3;
std::string path("game\\");
path += msgName;
@@ -278,7 +273,7 @@ long Message::AddExtraMsgFile(const char* msgName, long msgNumber) {
return -2;
//}
}
if (msgNumber == 0) msgNumber = msgNumCounter++;
long msgNumber = msgNumCounter++;
Message::gExtraGameMsgLists.emplace(msgNumber, list);
addedExtraMsgFiles.emplace(path, msgNumber);
return msgNumber;
sfall/Modules/Message.h
+1 -1
View File
@@ -63,7 +63,7 @@ public:
static ExtraGameMessageListsMap gExtraGameMsgLists;
static const fo::MessageList* gameMsgFiles[];
static long AddExtraMsgFile(const char* msgName, long msgNumber);
static long AddExtraMsgFile(const char* msgName);
};
}
sfall/Modules/Scripting/Handlers/Utils.cpp
+8 -4
View File
@@ -332,16 +332,20 @@ void op_message_str_game(OpcodeContext& ctx) {
}
void mf_add_extra_msg_file(OpcodeContext& ctx) {
long result = Message::AddExtraMsgFile(ctx.arg(0).strValue(), (ctx.numArgs() == 2) ? ctx.arg(1).rawValue() : 0);
if (ctx.numArgs() == 2) {
ctx.printOpcodeError("%s() - Warning: 2-arg form is deprecated; the 2nd argument is ignored.", ctx.getMetaruleName());
}
long result = Message::AddExtraMsgFile(ctx.arg(0).strValue());
switch (result) {
case -1 :
ctx.printOpcodeError("%s() - cannot add message file with the specified number.", ctx.getMetaruleName());
break;
//case -1 :
// ctx.printOpcodeError("%s() - cannot add message file with the specified number.", ctx.getMetaruleName());
// break;
case -2 :
ctx.printOpcodeError("%s() - error loading message file.", ctx.getMetaruleName());
break;
case -3 :
ctx.printOpcodeError("%s() - the limit of adding message files has been exceeded.", ctx.getMetaruleName());
break;
}
ctx.setReturn(result);
}