Troubleshooting and FAQ

Warning

This module was designed specially for sandbox tycoons. This kit does NOT support systems of wall/floor/roof (AKA bloxburg placement) placement and is very limited on open world placement systems (similar to that of Minecraft). Please be aware of this before continuing.

If you're having issues with the module, this page will attempt to address that and answer some frequent questions. Keep in mind, this page is very limited, and isn't updated as often as the rest of the wiki.

Troubleshooting

If the module does not work, make sure you're using the latest version. If you are not, you can try replacing the module with a newer version and see if that fixes the issue. Try looking through the categories to find your problem.

I have a warningThe module doesn't work at allPlacement is broken

• "Error code 201: The object that the model is moving on is not scaled correctly. Consider changing it."

  This warning indicates the plot you are using is not a multiple of the grid unit you have set. Either change your grid unit or rescale your plot. You can check to see if your grid size will work by printing the plot size modulus (%) the grid unit. If the value is == 0, you should not have any issues but any other value means the plot is not divisable by the grid size (you will get offsets).

• "Error code 301: You have improperly setup your callback function. Please input a valid callback"

  This warning indicates you have either disabled signals and didn't want to use callbacks or you've setup your callback function correctly. To fix this, input a valid callback function or enable signals and use them instead.

• "Your trying to activate placement too fast! Please slow down"

  This warning indicates you are attempting to activate placement too fast. Make sure you are not trying to activate placement in a loop or in a RunService method like :BindToRenderStep().

• "Error code 401: Grid size is too close to the plot size. To fix this, try lowering the grid size."

  This error indicates the chosen grid size is too large for the plot you are using. To fix this, reduce the grid size or increase the plot size.

• "Error code 501: Cannot find a surface to place on. Please make sure one is available."

  This error indicates the module could not find a surface to place on (only applies to placements without plots).

• Make sure you have inputted all required parameters in the new() function and the activate() function. Confirm with the code sample below that you include all of the parameters:

PlacementService.new(
    int GridUnit, 
    instance Itemlocation, 
    Enum RotateKey, Enum TerminateKey, Enum RaiseKey, Enum LowerKey, 
    Enum RotateKeyXBOX, Enum TerminateKeyXBOX, Enum RaiseKeyXBOX, Enum LowerKeyXBOX
)

The activate function requires it's own set of parameters. Check to make sure you have all of them:

PlacementInfo:activate(string ModelName, instance ItemHolder, instance Plot, bool StackableToggle, bool RotationType, bool AutoPlaceToggle)

Remember

XBOX Controls are not required and will default to their internal values if not included. The requestPlacement() function does not require you to include it's second parameter. It only requires you to pass a remote function. Callbacks are optional. You wont be able to add the later parameters though.

• Make sure your object exists and has a valid primary part. Objects that fail to satisfy this requirement will cause the module to error and will not work.

Make sure you have correctly implemented the server side code. Placement will not work unless everything is setup correctly on the client and server. A common issue is that you may not have a valid path for the remote function on the server. Make sure you input a valid path before play testing.

FAQ

Q. Wasn't this used to be named "Placement Module V3"?

A. Yes! The module was changed from "Placement Module V3" to "Placement Service" since "Placement Module V3" isn't easy remember, and is hard tell what it is without using the module prior.

Q. How do I delete objects?

A. The module does not handle any features other than the placement system. This is one of those features so you will have to research this and implement it yourself.

Q. How do I save my plot?

A. The module does not handle any features other than the placement system. This is one of those features so you will have to research this and implement it yourself.

Q. How would I add a bloxburg style placement system to your model?

A. The module does unfortunately NOT handle this feature. This is merely just a standard placement system where you can move and place objects down. You will have to implement this feature on your own.

Q. It is broken. How do I fix this?

A. The most likely reason for this, is that you have incorrectly setup the module. You will have to fix your code to fix this 99% of the time. You can also try checking for a newer version of the module.

Q. Is this module cross platform?

A. Yes! This module supports XBOX, PC and Mobile devices!

Q. Do I have to credit you for using this module?

A. You do not have to credit me for the module, however it is appreciated due to the module taking many hours to develop. You cannot claim the system as your own.