From 2dcff7a8cfdc24f88b0daedb5bf139b0abcce835 Mon Sep 17 00:00:00 2001
From: Kitty <58940527+kitty624@users.noreply.github.com>
Date: Mon, 15 Apr 2024 18:48:02 +0200
Subject: [PATCH] UB added missing subdirectory for Extra Items (#91)
added rhe missing subdirectory for Extra Items and moved existing files into the new subdirectory
---
.../ExtraItems/Extra Sector Items readme.txt | 76 +++++++++++++++++++
.../H11_0_ExtraItems_Experienced.xml | 38 +++++-----
.../H11_0_ExtraItems_Expert.xml | 34 ++++-----
.../H11_0_ExtraItems_Insane.xml | 34 ++++-----
.../H11_0_ExtraItems_Novice.xml | 34 ++++-----
.../ExtraItems/Extra Sector Items readme.txt | 76 +++++++++++++++++++
.../H11_0_ExtraItems_Experienced.xml | 38 +++++-----
.../H11_0_ExtraItems_Expert.xml | 34 ++++-----
.../H11_0_ExtraItems_Insane.xml | 34 ++++-----
.../H11_0_ExtraItems_Novice.xml | 34 ++++-----
.../A9_0_ExtraItems_Expert.xml | 40 +++++-----
.../ExtraItems/Extra Sector Items readme.txt | 76 +++++++++++++++++++
12 files changed, 388 insertions(+), 160 deletions(-)
create mode 100644 gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/Extra Sector Items readme.txt
rename gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/{ => ExtraItems}/H11_0_ExtraItems_Experienced.xml (96%)
rename gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/{ => ExtraItems}/H11_0_ExtraItems_Expert.xml (96%)
rename gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/{ => ExtraItems}/H11_0_ExtraItems_Insane.xml (96%)
rename gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/{ => ExtraItems}/H11_0_ExtraItems_Novice.xml (96%)
create mode 100644 gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/Extra Sector Items readme.txt
rename gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/{ => ExtraItems}/H11_0_ExtraItems_Experienced.xml (96%)
rename gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/{ => ExtraItems}/H11_0_ExtraItems_Expert.xml (96%)
rename gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/{ => ExtraItems}/H11_0_ExtraItems_Insane.xml (96%)
rename gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/{ => ExtraItems}/H11_0_ExtraItems_Novice.xml (96%)
rename gamedir/Data-UB/TableData/Map/{ => ExtraItems}/A9_0_ExtraItems_Expert.xml (96%)
create mode 100644 gamedir/Data-UB/TableData/Map/ExtraItems/Extra Sector Items readme.txt
diff --git a/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/Extra Sector Items readme.txt b/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/Extra Sector Items readme.txt
new file mode 100644
index 000000000..898f4062e
--- /dev/null
+++ b/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/Extra Sector Items readme.txt
@@ -0,0 +1,76 @@
+This is an old 1.13 Feature which seems to be hidden for Modders long time.
+This feature has been reworked by Headrock
+(edit: and since it got lost again, now revived)
+
+-------------------------
+XML filename format:
+-------------------------
+
+\tabledata\Map\ExtraItems\[SectorGrid]_[ZLevel]_ExtraItems_[DifficultyName].xml
+
+Examples:
+\TableData\Map\ExtraItems\A9_0_ExtraItems_Novice.xml -> for entering the A9 surface sector (Omerta) when playing novice difficulty.
+
+(edit: -> underground-levels see [NOTE] below)
+
+
+The following "DifficultyNames" are valid:
+
+- Novice
+- Experienced
+- Expert
+- Insane
+
+
+-------------------------
+XML content format:
+-------------------------
+
+
+ -
+ #
+ #
+ #
+ #
+ #
+
+
+
+
+-------------------------
+XML notes:
+-------------------------
+
+- For clarity, uiIndex should always come first. However, I've set it so that the position of uiIndex
+ in the list is not relevant (so long as it exists). Most XMLs work that way, and I think that's fine.
+
+- All other tags can come in any order.
+
+- Quantity can be set to any number, but will only create an item (or more) if above 0.
+ Quantity of 0 or less will not crash the game, it simply won't create items.
+ If this tag is completely omitted, the game will create one item by default.
+
+- Condition can be set to 1-100. If it is set outside these values, the item will not be created
+ (the game won't crash). If this tag is completely omitted, the item will have 100 condition.
+
+- Gridno can be set to any positive number, including 0. However, if it is out of bounds,
+ the game will generate a screen message that it could not place the item, but will not crash the game.
+ Obviously, there is no rational default for this tag, so it must always be included.
+
+- Visible can be set to 0 or 1. When 1, will create an item that is visible from the moment you enter the map.
+ Otherwise, a merc must spot the item by simple sight, like all other items on the map.
+ If this tag is omitted, the item is created with 0 visibility by default (must be spotted).
+
+- if GridNo is at closed container (like a crate, furniture, etc.), visible should be set to 1 (hidden)
+
+- random-items can also be used
+
+- As I understand, that's happening in realtime. So it's probably advised to not overdo it
+
+ It's meant to add a few goodies (differing on which difficulty level we're at), not to replace the item-placement via mapeditor
+
+- added a few example files to portrait the idea
+
+[NOTE: It's a bummer, but it doesn't seem to work with underground-levels. That might be an old issue, at least all examples I found, even going back to v4870, also only had ground-level in use as well. So, for the time being, it only works on ground-level (using only 0 for level, like in "A9_0_ExtraItems_Novice.xml")]
+
+(edited 22.08.2023)
\ No newline at end of file
diff --git a/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/H11_0_ExtraItems_Experienced.xml b/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/H11_0_ExtraItems_Experienced.xml
similarity index 96%
rename from gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/H11_0_ExtraItems_Experienced.xml
rename to gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/H11_0_ExtraItems_Experienced.xml
index 8b66b9e83..7f155faf3 100644
--- a/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/H11_0_ExtraItems_Experienced.xml
+++ b/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/H11_0_ExtraItems_Experienced.xml
@@ -1,19 +1,19 @@
-
-
-
-
- -
- 1354
- 3
- 100
- 5366
- 1
-
- -
- 1352
- 1
- 100
- 5366
- 1
-
-
+
+
+
+
+ -
+ 1354
+ 3
+ 100
+ 5366
+ 1
+
+ -
+ 1352
+ 1
+ 100
+ 5366
+ 1
+
+
diff --git a/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/H11_0_ExtraItems_Expert.xml b/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/H11_0_ExtraItems_Expert.xml
similarity index 96%
rename from gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/H11_0_ExtraItems_Expert.xml
rename to gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/H11_0_ExtraItems_Expert.xml
index 080212e4b..2b29236d1 100644
--- a/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/H11_0_ExtraItems_Expert.xml
+++ b/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/H11_0_ExtraItems_Expert.xml
@@ -1,18 +1,18 @@
-
-
-
- -
- 1354
- 3
- 100
- 5366
- 1
-
- -
- 1352
- 1
- 100
- 5366
- 1
-
+
+
+
+ -
+ 1354
+ 3
+ 100
+ 5366
+ 1
+
+ -
+ 1352
+ 1
+ 100
+ 5366
+ 1
+
\ No newline at end of file
diff --git a/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/H11_0_ExtraItems_Insane.xml b/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/H11_0_ExtraItems_Insane.xml
similarity index 96%
rename from gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/H11_0_ExtraItems_Insane.xml
rename to gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/H11_0_ExtraItems_Insane.xml
index 080212e4b..2b29236d1 100644
--- a/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/H11_0_ExtraItems_Insane.xml
+++ b/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/H11_0_ExtraItems_Insane.xml
@@ -1,18 +1,18 @@
-
-
-
- -
- 1354
- 3
- 100
- 5366
- 1
-
- -
- 1352
- 1
- 100
- 5366
- 1
-
+
+
+
+ -
+ 1354
+ 3
+ 100
+ 5366
+ 1
+
+ -
+ 1352
+ 1
+ 100
+ 5366
+ 1
+
\ No newline at end of file
diff --git a/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/H11_0_ExtraItems_Novice.xml b/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/H11_0_ExtraItems_Novice.xml
similarity index 96%
rename from gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/H11_0_ExtraItems_Novice.xml
rename to gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/H11_0_ExtraItems_Novice.xml
index 080212e4b..2b29236d1 100644
--- a/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/H11_0_ExtraItems_Novice.xml
+++ b/gamedir/Data-UB/AddOns/Data-UB-1.13/TableData/Map/ExtraItems/H11_0_ExtraItems_Novice.xml
@@ -1,18 +1,18 @@
-
-
-
- -
- 1354
- 3
- 100
- 5366
- 1
-
- -
- 1352
- 1
- 100
- 5366
- 1
-
+
+
+
+ -
+ 1354
+ 3
+ 100
+ 5366
+ 1
+
+ -
+ 1352
+ 1
+ 100
+ 5366
+ 1
+
\ No newline at end of file
diff --git a/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/Extra Sector Items readme.txt b/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/Extra Sector Items readme.txt
new file mode 100644
index 000000000..898f4062e
--- /dev/null
+++ b/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/Extra Sector Items readme.txt
@@ -0,0 +1,76 @@
+This is an old 1.13 Feature which seems to be hidden for Modders long time.
+This feature has been reworked by Headrock
+(edit: and since it got lost again, now revived)
+
+-------------------------
+XML filename format:
+-------------------------
+
+\tabledata\Map\ExtraItems\[SectorGrid]_[ZLevel]_ExtraItems_[DifficultyName].xml
+
+Examples:
+\TableData\Map\ExtraItems\A9_0_ExtraItems_Novice.xml -> for entering the A9 surface sector (Omerta) when playing novice difficulty.
+
+(edit: -> underground-levels see [NOTE] below)
+
+
+The following "DifficultyNames" are valid:
+
+- Novice
+- Experienced
+- Expert
+- Insane
+
+
+-------------------------
+XML content format:
+-------------------------
+
+
+ -
+ #
+ #
+ #
+ #
+ #
+
+
+
+
+-------------------------
+XML notes:
+-------------------------
+
+- For clarity, uiIndex should always come first. However, I've set it so that the position of uiIndex
+ in the list is not relevant (so long as it exists). Most XMLs work that way, and I think that's fine.
+
+- All other tags can come in any order.
+
+- Quantity can be set to any number, but will only create an item (or more) if above 0.
+ Quantity of 0 or less will not crash the game, it simply won't create items.
+ If this tag is completely omitted, the game will create one item by default.
+
+- Condition can be set to 1-100. If it is set outside these values, the item will not be created
+ (the game won't crash). If this tag is completely omitted, the item will have 100 condition.
+
+- Gridno can be set to any positive number, including 0. However, if it is out of bounds,
+ the game will generate a screen message that it could not place the item, but will not crash the game.
+ Obviously, there is no rational default for this tag, so it must always be included.
+
+- Visible can be set to 0 or 1. When 1, will create an item that is visible from the moment you enter the map.
+ Otherwise, a merc must spot the item by simple sight, like all other items on the map.
+ If this tag is omitted, the item is created with 0 visibility by default (must be spotted).
+
+- if GridNo is at closed container (like a crate, furniture, etc.), visible should be set to 1 (hidden)
+
+- random-items can also be used
+
+- As I understand, that's happening in realtime. So it's probably advised to not overdo it
+
+ It's meant to add a few goodies (differing on which difficulty level we're at), not to replace the item-placement via mapeditor
+
+- added a few example files to portrait the idea
+
+[NOTE: It's a bummer, but it doesn't seem to work with underground-levels. That might be an old issue, at least all examples I found, even going back to v4870, also only had ground-level in use as well. So, for the time being, it only works on ground-level (using only 0 for level, like in "A9_0_ExtraItems_Novice.xml")]
+
+(edited 22.08.2023)
\ No newline at end of file
diff --git a/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/H11_0_ExtraItems_Experienced.xml b/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/H11_0_ExtraItems_Experienced.xml
similarity index 96%
rename from gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/H11_0_ExtraItems_Experienced.xml
rename to gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/H11_0_ExtraItems_Experienced.xml
index b3cb0a1b6..9781f3738 100644
--- a/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/H11_0_ExtraItems_Experienced.xml
+++ b/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/H11_0_ExtraItems_Experienced.xml
@@ -1,19 +1,19 @@
-
-
-
-
- -
- 338
- 3
- 100
- 5366
- 1
-
- -
- 336
- 1
- 100
- 5366
- 1
-
-
+
+
+
+
+ -
+ 338
+ 3
+ 100
+ 5366
+ 1
+
+ -
+ 336
+ 1
+ 100
+ 5366
+ 1
+
+
diff --git a/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/H11_0_ExtraItems_Expert.xml b/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/H11_0_ExtraItems_Expert.xml
similarity index 96%
rename from gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/H11_0_ExtraItems_Expert.xml
rename to gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/H11_0_ExtraItems_Expert.xml
index 273588ca0..2930b79ab 100644
--- a/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/H11_0_ExtraItems_Expert.xml
+++ b/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/H11_0_ExtraItems_Expert.xml
@@ -1,18 +1,18 @@
-
-
-
- -
- 338
- 3
- 100
- 5366
- 1
-
- -
- 336
- 1
- 100
- 5366
- 1
-
+
+
+
+ -
+ 338
+ 3
+ 100
+ 5366
+ 1
+
+ -
+ 336
+ 1
+ 100
+ 5366
+ 1
+
\ No newline at end of file
diff --git a/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/H11_0_ExtraItems_Insane.xml b/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/H11_0_ExtraItems_Insane.xml
similarity index 96%
rename from gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/H11_0_ExtraItems_Insane.xml
rename to gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/H11_0_ExtraItems_Insane.xml
index 273588ca0..2930b79ab 100644
--- a/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/H11_0_ExtraItems_Insane.xml
+++ b/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/H11_0_ExtraItems_Insane.xml
@@ -1,18 +1,18 @@
-
-
-
- -
- 338
- 3
- 100
- 5366
- 1
-
- -
- 336
- 1
- 100
- 5366
- 1
-
+
+
+
+ -
+ 338
+ 3
+ 100
+ 5366
+ 1
+
+ -
+ 336
+ 1
+ 100
+ 5366
+ 1
+
\ No newline at end of file
diff --git a/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/H11_0_ExtraItems_Novice.xml b/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/H11_0_ExtraItems_Novice.xml
similarity index 96%
rename from gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/H11_0_ExtraItems_Novice.xml
rename to gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/H11_0_ExtraItems_Novice.xml
index 273588ca0..2930b79ab 100644
--- a/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/H11_0_ExtraItems_Novice.xml
+++ b/gamedir/Data-UB/AddOns/Data-UB-Vanilla/TableData/Map/ExtraItems/H11_0_ExtraItems_Novice.xml
@@ -1,18 +1,18 @@
-
-
-
- -
- 338
- 3
- 100
- 5366
- 1
-
- -
- 336
- 1
- 100
- 5366
- 1
-
+
+
+
+ -
+ 338
+ 3
+ 100
+ 5366
+ 1
+
+ -
+ 336
+ 1
+ 100
+ 5366
+ 1
+
\ No newline at end of file
diff --git a/gamedir/Data-UB/TableData/Map/A9_0_ExtraItems_Expert.xml b/gamedir/Data-UB/TableData/Map/ExtraItems/A9_0_ExtraItems_Expert.xml
similarity index 96%
rename from gamedir/Data-UB/TableData/Map/A9_0_ExtraItems_Expert.xml
rename to gamedir/Data-UB/TableData/Map/ExtraItems/A9_0_ExtraItems_Expert.xml
index 77285d18a..9915e4fcd 100644
--- a/gamedir/Data-UB/TableData/Map/A9_0_ExtraItems_Expert.xml
+++ b/gamedir/Data-UB/TableData/Map/ExtraItems/A9_0_ExtraItems_Expert.xml
@@ -1,20 +1,20 @@
-
-
-
+
+
+
diff --git a/gamedir/Data-UB/TableData/Map/ExtraItems/Extra Sector Items readme.txt b/gamedir/Data-UB/TableData/Map/ExtraItems/Extra Sector Items readme.txt
new file mode 100644
index 000000000..898f4062e
--- /dev/null
+++ b/gamedir/Data-UB/TableData/Map/ExtraItems/Extra Sector Items readme.txt
@@ -0,0 +1,76 @@
+This is an old 1.13 Feature which seems to be hidden for Modders long time.
+This feature has been reworked by Headrock
+(edit: and since it got lost again, now revived)
+
+-------------------------
+XML filename format:
+-------------------------
+
+\tabledata\Map\ExtraItems\[SectorGrid]_[ZLevel]_ExtraItems_[DifficultyName].xml
+
+Examples:
+\TableData\Map\ExtraItems\A9_0_ExtraItems_Novice.xml -> for entering the A9 surface sector (Omerta) when playing novice difficulty.
+
+(edit: -> underground-levels see [NOTE] below)
+
+
+The following "DifficultyNames" are valid:
+
+- Novice
+- Experienced
+- Expert
+- Insane
+
+
+-------------------------
+XML content format:
+-------------------------
+
+
+ -
+ #
+ #
+ #
+ #
+ #
+
+
+
+
+-------------------------
+XML notes:
+-------------------------
+
+- For clarity, uiIndex should always come first. However, I've set it so that the position of uiIndex
+ in the list is not relevant (so long as it exists). Most XMLs work that way, and I think that's fine.
+
+- All other tags can come in any order.
+
+- Quantity can be set to any number, but will only create an item (or more) if above 0.
+ Quantity of 0 or less will not crash the game, it simply won't create items.
+ If this tag is completely omitted, the game will create one item by default.
+
+- Condition can be set to 1-100. If it is set outside these values, the item will not be created
+ (the game won't crash). If this tag is completely omitted, the item will have 100 condition.
+
+- Gridno can be set to any positive number, including 0. However, if it is out of bounds,
+ the game will generate a screen message that it could not place the item, but will not crash the game.
+ Obviously, there is no rational default for this tag, so it must always be included.
+
+- Visible can be set to 0 or 1. When 1, will create an item that is visible from the moment you enter the map.
+ Otherwise, a merc must spot the item by simple sight, like all other items on the map.
+ If this tag is omitted, the item is created with 0 visibility by default (must be spotted).
+
+- if GridNo is at closed container (like a crate, furniture, etc.), visible should be set to 1 (hidden)
+
+- random-items can also be used
+
+- As I understand, that's happening in realtime. So it's probably advised to not overdo it
+
+ It's meant to add a few goodies (differing on which difficulty level we're at), not to replace the item-placement via mapeditor
+
+- added a few example files to portrait the idea
+
+[NOTE: It's a bummer, but it doesn't seem to work with underground-levels. That might be an old issue, at least all examples I found, even going back to v4870, also only had ground-level in use as well. So, for the time being, it only works on ground-level (using only 0 for level, like in "A9_0_ExtraItems_Novice.xml")]
+
+(edited 22.08.2023)
\ No newline at end of file