Skip to content

Commit 33ca08d

Browse files
Merge branch 'community-open' of https://github.com/user-grinch/Project-Props into community-open
2 parents c66b0fb + 62f5ca3 commit 33ca08d

File tree

1 file changed

+119
-60
lines changed

1 file changed

+119
-60
lines changed

README.md

Lines changed: 119 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -1,74 +1,118 @@
11
# Project Props 3 Community
22

3-
**Project Props 3.0 Community** is the official release, based on the community branch by **Zeneric** which is based on [Project Props V2.2 Fixes](https://discord.com/channels/793480791509565440/1081007139314741248) — now enhanced with [FastLoader](https://github.com/user-grinch/FastLoader) for full **open file structure** support. This makes the mod fully editable, stable, and compatible with other mods.
3+
**Project Props 3 Community** is the official release, based on the community branch by **Zeneric** which itself was based on [Project Props V2.2 Fixes](https://discord.com/channels/793480791509565440/1081007139314741248) — now enhanced with [FastLoader](https://github.com/user-grinch/FastLoader) for full **open file structure** support. This makes the mod fully editable, stable, and compatible with other mods.
44

5-
## You need:
6-
- [Open Limit Adjuster v1.5.9](https://github.com/GTAmodding/III.VC.SA.LimitAdjuster/releases) - default settings
7-
- [FastLoader](https://github.com/user-grinch/FastLoader/releases) - created specially for Project Props 3 purpose
5+
With version **3**, the mod is **bigger, more beautiful, and more stable than ever before**.
86

9-
NOT ALWAYS, but on many configuration it's mandatory:
10-
- [fastman92 limit adjuster](https://www.mixmods.com.br/2022/01/fastman92-limit-adjuster/) If you use other object.dat mods, you might need Fastaman Limit Adjuster limit set to ```Object info entries = 200```
7+
<p align="center">
8+
<img src="https://github.com/user-attachments/assets/204bb565-5bde-4819-9d92-94c1fb7cf329" alt="Project Props Community RC1" />
9+
</p>
1110

12-
## ✅ Key Features
11+
## 🫂 First off all:
12+
💬**JOIN OUR DISCORD SERVER: [Invitation](https://discord.gg/4e2PkhYq)**
1313

14-
- Supports **breakable objects**
15-
- **Text-based IPLs** are back
16-
- Thanks to the [FastLoader](https://github.com/user-grinch/FastLoader) no crashes with other `.dat` mods (e.g. *Proper Fixes*, *Combat FX Update*)
14+
Once inside, use the correct channel:
15+
- `#crash-help` → if your game crashes
16+
- `#position-bugs` → if you find misplaced or floating props
17+
- `#mapping-lab` → to share new mapping ideas or contributions
18+
- `#general` → for general discussion and questions
1719

20+
This helps us keep things organized and ensures faster fixes!
1821

19-
<p align="center">
20-
<img src="https://github.com/user-attachments/assets/204bb565-5bde-4819-9d92-94c1fb7cf329" alt="Project Props Community RC1" />
21-
</p>
2222

23-
2423

25-
## ✨ What’s New?
24+
## ℹ️ You need:
25+
**If you start your journey with modding:**
26+
- [Essentials Pack](https://www.mixmods.com.br/2019/06/sa-essentials-pack/)
2627

27-
- ✅ All content from version **2.3** restored
28-
- ✅ Includes **never-published assets** from the original Grinch's repository
29-
- ✅ All [Community Fixes](https://libertycity.net/files/gta-san-andreas/221956-project-props-v2-2-fixes.html) included
30-
- ✅ Fully compatible with **Urbanize!**
31-
- ✅ No crashes reported during testing
28+
**Mandatory:**
29+
- [Open Limit Adjuster v1.5.9](https://github.com/GTAmodding/III.VC.SA.LimitAdjuster/releases) - use with default settings
30+
- [FastLoader](https://github.com/user-grinch/FastLoader/releases) - created specially for Project Props 3 purpose, ensures compatibility with Proper Fixes and makes props breakable
31+
32+
**Highly Recommended:**
33+
- [fastman92 limit adjuster](https://libertycity.net/files/gta-san-andreas/223963-fastman92-limit-adjuster.html) - increases stability, when you have other object.dat mods it's mandatory
34+
35+
Make sure to use these settings in your `fastman92limitAdjuster_GTASA.ini`:
36+
37+
```ini
38+
Object info entries = 200
39+
```
40+
Without this setting you can **start a new game**, but **loading from save games will fail**. The game won’t crash in a classic way – instead you’ll get a black screen on load.
3241

33-
42+
For reporting purposes, also set:
3443

35-
## 🔧 Additions & Fixes
44+
```ini
45+
Register global exception handler = 0
46+
```
47+
This ensures you get **proper crash messages** from the Essentials Pack. FLA’s own crash log is basically useless: it only shows the last loaded file, which is often misleading.
3648

37-
- ✔ Added missing **textures** for never published new props
38-
- ✔ Fixed **positioning** for several models
39-
- ✔ Updated `ProjectProps.ini` to work with `ProjectProps.asi` (includes lampposts, hydrants)
40-
-**Weeds** optimized by @.zeneric - thousand of automaticly generated weeds models are now merged into batches, to optimise memory usage
41-
- ✔ Disabled **rubbish props** added by Grinch (original SA rubbish remains intact) → Goal: migrate those to `procobj.dat` for better dynamic loading
4249

50+
💬 **ONCE AGAIN JOIN OUR DISCORD SERVER: [Invitation](https://discord.gg/4e2PkhYq)**
4351

44-
## 📦 Included Projects (With Permission)
52+
On this [**Channel**](https://discord.com/channels/689515979847237649/1414177877515046934) you will get all the support needed to solve any compatibility issues.
4553

46-
This release **merges content from the following mods**, with full permission from their original authors:
54+
## ⚠️ Proper Fixes Compatibility Note
4755

48-
- 🔗 [Mixsylent's Objectopia v1.4.0](https://forum.mixmods.com.br/f6-mapas-objetos/t8549-sa-wip-objectopia-v1-4-0?sid=cc4bd3d576bf30378ef8b398995cbf0a)
49-
- 🔗 *Lando Props* – featuring:
50-
- Easter Basin Naval Station (SF)
51-
- Simple Beach (LS)
52-
- 🔗 [James's Props – Improved Map Environment](https://libertycity.net/files/gta-san-andreas/209720-jamess-props-improved-map-environment.html)
53-
- 🔗 *Reaper’s Camp* – a **Breaking Bad-inspired** trailer site with realistic detailing
56+
**Proper Fixes** comes with **two different `procobj.dat` files**, which is confusing – and they do completely opposite things. Since Project Props heavily depends on this system, here’s a clear explanation:
57+
58+
Files in Proper Fixes
59+
- `Proper_Fixes\(optional - increase vegetation distance)\Increased Vegetation Distance\data\procobj.dat`
60+
Purpose: disables all procedural plants/rocks, because *Increased Vegetation Distance (IVD)* places them via `.ipl` instead.
61+
IPL has greater draw distance, so vegetation doesn’t "pop in". This file is basically empty.
62+
63+
- `Proper_Fixes\Proper Fixes\Misc\data\procobj.dat`
64+
Purpose: fixes Rockstar’s original vegetation placements to avoid floating objects.
65+
But with IVD installed, this is **not necessary**, since IVD replaces vegetation anyway.
66+
67+
Our `procobj.dat`
68+
- `Project-Props\modloader\ProjectProps 3.1 Community\Custom Props (fastloader)\Procedural Objects\procobj.dat`
69+
Does what Rockstar never finished: a proper procedural system that spawns **small details** (garbage, weeds, cigarette butts, shells, etc.) automatically across surfaces, avoiding manual placements.
5470

55-
### ⚠️ Urbanize Compatibility Note
71+
Recommended Setup (Maximum Compatibility: Project Props + IVD + Proper Fixes)
72+
1. Copy `procobj.dat` from *Increased Vegetation Distance* into the **original game data folder** (replace the vanilla one).
73+
→ All vegetation will then be handled by IVD `.ipl` files = no duplication.
5674

57-
In the .settings folder you can find two configurations.
58-
If you prefere Urbanize Mailboxes, Hydrants and Parking Meters - Use loader.txt from 'Urbanize over Project Props' folder
59-
If you want the best experience use default settings and disable Urbanize Mailboxes, Hydrants and Parking Meters in the modloader/Urbanize/Map/Loader.txt
75+
2. Delete `Proper_Fixes\Proper Fixes\Misc\data\procobj.dat`.
76+
→ Not needed anymore, IVD already manages vegetation.
6077

61-
### ⚠️ Project 2dfx Compatibility Note
78+
3. The elephant in the room:
79+
- `Proper_Fixes\Proper Fixes\Misc\data\.objectdat\object.dat`
80+
- By default this is disabled.
81+
- With **FastLoader** you can now enable it safely:
82+
Rename it to `object.fastloader` and delete `.` from the folder's name. FastLoader will handle it without crashes.
6283

63-
For **Project 2dfx**, make sure to **disable loading of all binary IPLs**:
84+
This way you get:
85+
- Proper Fixes bug corrections
86+
- Increased Vegetation Distance with high draw distance
87+
- Project Props procedural small details
88+
- Full FastLoader compatibility
6489

90+
## ⚠️ Procobj.dat / surfinfo.dat Mods
91+
92+
Mods like *Sidewalk Weeds* (our mod already does the same) interfere with the **procedural object system** used in Project Props.
93+
Compatibility with such mods is **not supported** – and in fact, you don’t need them anymore.
94+
95+
In general, **modloader** has no problem merging multiple `procobj.dat` files.
96+
However, other mods that modify `surfinfo.dat` may conflict and cause crashes when used alongside Project Props.
97+
98+
## ⚠️ Urbanize Compatibility Note
99+
100+
If you prefere Urbanize Mailboxes, Hydrants and Parking Meters - Use default settings
101+
If you want the best experience disable Urbanize Mailboxes, Hydrants and Parking Meters in the modloader/Urbanize/Map/Loader.txt
102+
Delete or #comment those lines:
65103
```ini
66-
LoadAllBinaryIPLs = 0
104+
IPL data\maps\Urbanize - Mails.ipl
105+
IPL data\maps\Urbanize - Street Side.ipl
67106
```
107+
## ⚠️ Project 2dfx Compatibility Note
68108

69-
This setting normally forces the game to load *all* IPL files at once, which can exceed the engine’s internal limits for object instances.
109+
For **Project 2dfx**, make sure to **disable loading of all binary IPLs**. If not game will crash.
70110

71-
Potential Bugs: After tens of thousands of props (not counted precisely yet), the game starts duplicating objects.
111+
```ini
112+
LoadAllBinaryIPLs = 0
113+
```
114+
115+
Potential Bugs (it does not happen for everybody!): fter tens of thousands of props (not counted precisely yet), the game starts duplicating objects.
72116

73117
When combining **Urbanize + Improved Vegetation Distance + Project Props Community**, increasing values in the `[IDE Tweaker]` section causes props to spawn **twice in the same spot** (especially noticeable with breakables like lampposts, fences, etc.).
74118

@@ -81,25 +125,45 @@ When combining **Urbanize + Improved Vegetation Distance + Project Props Communi
81125
- extended draw distance
82126

83127
By default, **Project Props Community** ships with settings that leave some spare headroom for additional objects.
84-
For even more props, check out our `loader.txt`.
85128

129+
## ✨ Key Features
86130

87-
🧠 The issue is not with the IPL content itself, but with the **total number of objects loaded into memory**.
131+
- ✅ Added thousands of new props!
132+
- ✅ Extended, reworked **procedural spawn system - procobj.dat** for garbage and small details across the entire map. Carefully crafted using the original game’s mechanics, with **marginal impact on FPS**
133+
- ✅ Thanks to the [FastLoader](https://github.com/user-grinch/FastLoader) no crashes with other `.dat` mods (e.g. *Proper Fixes*, *Combat FX Update*)
134+
- ✅ All content from version **2.3** restored
135+
- ✅ Includes **never-published assets** from the original Grinch's repository, added missing **textures** for never published new props
136+
- ✅ All [Community Fixes](https://libertycity.net/files/gta-san-andreas/221956-project-props-v2-2-fixes.html) included
137+
- ✅ Fully compatible with **Urbanize!**
138+
- ✅ No crashes reported during testing
139+
- ✅ Extended Residue Objects functionality (ProjectProps.asi) on all the lamppost and traffic lights
140+
- ✅ Fixed occasionall crash with the script ProjectProps.asi
141+
- ✅ Fixed **positioning** for hundreds of models, positioning bugs are very rare now
142+
-**Weeds** optimized by @.zeneric - thousand of automaticly generated weeds models are now merged into batches, to optimise memory usage, it's a technique from modern games
143+
144+
145+
## 📦 Included Projects with permissions and active colaboration with the authors
146+
147+
- 🔗 [Mixsylent's Objectopia v1.4.0](https://forum.mixmods.com.br/f6-mapas-objetos/t8549-sa-wip-objectopia-v1-4-0?sid=cc4bd3d576bf30378ef8b398995cbf0a)
148+
- 🔗 *Lando Props* – featuring:
149+
- Easter Basin Naval Station (SF)
150+
- Simple Beach (LS)
151+
- 🔗 [James's Props – Improved Map Environment](https://libertycity.net/files/gta-san-andreas/209720-jamess-props-improved-map-environment.html)
152+
- 🔗 *Reaper’s Camp* – a **Breaking Bad-inspired** trailer site with realistic detailing
88153

89154
## ⚙️ About Merging
90155

91-
All merging was performed using a **custom toolchain**:
156+
All merging was performed using a **custom script**. The script performs smart collision detection, thanks to that we were able to merge many mapping projects and assure Urbanize compatibility.
157+
If you notice any **object collision**, visual glitch, or bug:
158+
- **Please report it!**
159+
- Include a **screenshot** and **exact XYZ coordinates**
160+
- We patch bugs quickly and consistently !
92161

93-
- 🔁 A mix of **automated scripts** and **manual validation**
94-
- 🧠 The script performs smart detection but has **known limitations**:
95-
- Large or oddly positioned objects may bypass automatic deduplication due to coordinate system constraints
96-
- 🐞 If you notice any **object collision**, visual glitch, or bug:
97-
- **Please report it!**
98-
Include a **screenshot** and **exact XYZ coordinates**
99-
→ We patch bugs **quickly and consistently**
162+
## 🛠️ How to Contribute (Add Your Own Props!)
100163

164+
**JOIN OUR DISCORD SERVER: [Invitation](https://discord.gg/4e2PkhYq)**
101165

102-
### 🛠️ How to Contribute (Add Your Own Props!)
166+
💬 On this [**Channel**](https://discord.com/channels/689515979847237649/1414178215420760124) you can ask the questions and submit your contributions.
103167

104168
Want to **add more props or maps** to the project? It's easy — and we **encourage it**!
105169

@@ -118,11 +182,7 @@ Want to **add more props or maps** to the project? It's easy — and we **encour
118182
- **San Fierro**
119183
- **Las Venturas**
120184

121-
Help us expand the world — one prop at a time!
122-
123-
124185
## 🤝 Credits
125-
126186
Special thanks to:
127187
- **Grinch_, Zeneric** — The GOATS
128188
- **Reaper** — mapping, creative director
@@ -134,4 +194,3 @@ Special thanks to:
134194
- **CatchyKetchup, KaiQ, Davve95** — 2.2 Fixes
135195

136196

137-
## 💬 *Enjoy modding and keep breaking stuff — responsibly.*

0 commit comments

Comments
 (0)