Skip to content

user-grinch/Project-Props

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 

Repository files navigation

Project Props 3 Community

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 — now enhanced with FastLoader for full open file structure support. This makes the mod fully editable, stable, and compatible with other mods.

With version 3, the mod is bigger, more beautiful, and more stable than ever before.

Project Props Community RC1

🫂 First off all:

💬JOIN OUR DISCORD SERVER: Invitation

Once inside, use the correct channel:

  • #crash-help → if your game crashes
  • #position-bugs → if you find misplaced or floating props
  • #mapping-lab → to share new mapping ideas or contributions
  • #general → for general discussion and questions

This helps us keep things organized and ensures faster fixes!

ℹ️ You need:

If you’re just starting your journey with modding:


Mandatory:


Optional:

  • FastLoader – created specifically for Project Props 3; it loads object.dat lines for newly added objects and makes them breakable.
    Without it: Nothing serious, but newly added objects (e.g. road signs) won’t be breakable.

Highly Recommended:

  • fastman92 limit adjuster – improves stability. Requires a small configuration (see below). (Remember to always install it in the main directory of the game!) Without it: For some users you can start a new game, but loading saved games will fail.

Make sure to use these settings in your fastman92limitAdjuster_GTASA.ini:

Object info entries = 200

For reporting purposes, also set:

Register global exception handler = 0

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.

💬 ONCE AGAIN JOIN OUR DISCORD SERVER: Invitation

On this Channel you will get all the support needed to solve any compatibility issues.

⚠️ Proper Fixes Compatibility Note

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:

Files in Proper Fixes

  • Proper_Fixes\(optional - increase vegetation distance)\Increased Vegetation Distance\data\procobj.dat
    Purpose: disables all procedural plants/rocks, because Increased Vegetation Distance (IVD) places them via .ipl instead.
    IPL has greater draw distance, so vegetation doesn’t "pop in". This file is basically empty.

  • Proper_Fixes\Proper Fixes\Misc\data\procobj.dat
    Purpose: fixes Rockstar’s original vegetation placements to avoid floating objects.
    But with IVD installed, this is not necessary, since IVD replaces vegetation anyway.

Our procobj.dat

  • Project-Props\modloader\ProjectProps 3.1 Community\Custom Props (fastloader)\Procedural Objects\procobj.dat
    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.

Recommended Setup (Maximum Compatibility: Project Props + IVD + Proper Fixes)

  1. Copy procobj.dat from Increased Vegetation Distance into the original game data folder (replace the vanilla one).
    → All vegetation will then be handled by IVD .ipl files = no duplication.

  2. Delete Proper_Fixes\Proper Fixes\Misc\data\procobj.dat.
    → Not needed anymore, IVD already manages vegetation.

    This way you get:

  • Proper Fixes bug corrections
  • Increased Vegetation Distance with high draw distance
  • Project Props procedural small details

⚠️ Object.dat mods

Mods that edit object.dat values of original positions must be merged manually and copied to the /data folder — Fastloader enforces this behavior.
Project Props 3 uses Fastloader only to load additional lines for newly added objects into the object.dat file inside /data.

⚠️ Procobj.dat / surfinfo.dat Mods

Mods like Sidewalk Weeds (our mod already does the same) interfere with the procedural object system used in Project Props.
Compatibility with such mods is not supported – and in fact, you don’t need them anymore.

In general, modloader has no problem merging multiple procobj.dat files.
However, other mods that modify surfinfo.dat may conflict and cause crashes when used alongside Project Props.

⚠️ Urbanize Compatibility Note

If you prefere Urbanize Mailboxes, Hydrants and Parking Meters - Use default settings If you want the best experience disable Urbanize Mailboxes, Hydrants and Parking Meters in the modloader/Urbanize/Map/Loader.txt Delete or #comment those lines:

IPL data\maps\Urbanize - Mails.ipl
IPL data\maps\Urbanize - Street Side.ipl

⚠️ Project 2dfx Compatibility Note

For Project 2dfx, make sure to disable loading of all binary IPLs. If not game will crash.

LoadAllBinaryIPLs = 0

Potential Bugs (it does not happen for everybody!): fter tens of thousands of props (not counted precisely yet), the game starts duplicating objects.

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.).

👉 Don’t worry — the game doesn’t crash (though honestly, it feels like it should).

✅ The Key is Balance

  • More draw distance in Project2dfx (only IDE Tweaker) = fewer props you can safely load in .ipl files without triggering duplicates.
  • Everyone needs to find their own sweet spot between:
    • total prop count
    • extended draw distance

By default, Project Props Community ships with settings that leave some spare headroom for additional objects.

✨ Key Features

  • ✅ Added thousands of new props!
  • ✅ 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
  • ✅ Thanks to the FastLoader no crashes with other .dat mods (e.g. Proper Fixes, Combat FX Update)
  • ✅ All content from version 2.3 restored
  • ✅ Includes never-published assets from the original Grinch's repository, added missing textures for never published new props
  • ✅ All Community Fixes included
  • ✅ Fully compatible with Urbanize!
  • ✅ No crashes reported during testing
  • ✅ Extended Residue Objects functionality (ProjectProps.asi) on all the lamppost and traffic lights
  • ✅ Fixed occasionall crash with the script ProjectProps.asi
  • ✅ Fixed positioning for hundreds of models, positioning bugs are very rare now
  • 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

📦 Included Projects with permissions and active colaboration with the authors

⚙️ About Merging

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. If you notice any object collision, visual glitch, or bug:

  • Please report it!
  • Include a screenshot and exact XYZ coordinates
  • We patch bugs quickly and consistently !

🛠️ How to Contribute (Add Your Own Props!)

JOIN OUR DISCORD SERVER: Invitation

💬 On this Channel you can ask the questions and submit your contributions.

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

🧰 Use our custom editor:
👉 Map Editor – by user-grinch

Steps:

  1. Install this mod locally to avoid creating conflicts with existing props
  2. Use the editor to place your objects (IPL-based workflow)
  3. Send us your .ipl file for testing
  4. If your submission passes our quality check, it will be officially added to the next release

We're especially looking for contributions in:

  • Rural areas
  • San Fierro
  • Las Venturas

🤝 Credits

Special thanks to:

  • Grinch_, Zeneric — The GOATS
  • Reaper — mapping, creative director
  • James Harlet — mapping
  • LandoF — mapping
  • Matslick — coordination, research
  • mixsylent - for Objectopia
  • lanldsd - for More Vegetation
  • CatchyKetchup, KaiQ, Davve95 — 2.2 Fixes

About

A props modification for Grand Theft Auto San Andreas

Resources

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •