[1.12.30+] Limits for draft attributes and privileged code deprecation

Learn here how to create and use plugins.

Moderators: Scenario Moderators, Plugin Moderators

User avatar
JustAnyone
Developer
Posts: 3655
Joined: 23 Jul 2017, 12:45
Location: Easter Island
Plugins: Showcase Store

Platform

[1.12.30+] Limits for draft attributes and privileged code deprecation

#1

Post by JustAnyone »

Hello Plugin Creators,

We’re announcing two major changes that will affect plugin creation and management: new limits for certain draft attributes and the official deprecation of privileged codes.

1. New Limits for Draft Attributes (Power, Water, and Influences)
To streamline moderation and ensure a balanced in-game economy in regular game modes (Easy, Middle, and Hard), we are implementing limits on certain draft properties, specifically power, water, and influences. Note, that power and water output was already capped by the building's size, these new limits additionally cap the value output based on monthly price.

These limits are designed to ensure that a plugin's utility (like power generation or water production) is reasonably justified by its monthly price and size.
  • Implementation Timeline: You may have first observed these changes in beta 1.12.30. Based on community feedback, we have since relaxed some limits in 1.12.31 to reduce impact while still achieving our balancing goals.
  • What this means for your plugins: If your plugin's property (e.g., power output) exceeds the new limit for its price point, the game will automatically cap that value.
  • Checking for Limits: If your draft property gets limited, the game will log a message in the out.txt file. The log entry will clearly state the limit applied, as seen in the example:

    Code: Select all

    [BuildingDraft] limit $dsa_office00 (public) supported influence MANAGEMENT: 500 -> 377
    image.png
Impact Assessment
Based on our analysis, the majority of plugins currently available on the plugin store should remain unaffected by these changes.

Regardless, we ask you to review and update your plugins that are represented by the magenta dots on the attached chart. These are the plugins most likely to be capped by the new limits.
image.png
Note on Influences
Influences act per tile. This means a larger building with the same influence value will have a total influence equal to `width * height` times that value. A base influence value of 100 is considered quite high; for context, almost all native buildings use values smaller than 200. You may consult public game assets for exact values.

We've opted to apply these limits now as a less invasive measure compared to suddenly setting the monthly price based on power, water, and influences. While both approaches can affect existing cities, this method is easier to fix and prevents cities from suddenly having massive, unexpected spending due to overpowered plugins.
  • For Regular Players: If you are a plugin user and notice a broken plugin as a result of these changes, please report it to the plugin creator so they can fix it.
  • For Creative Players: For players who enjoy a creative sandbox environment, the Uber mode should always bypass influence requirements, meaning such OP plugins aren't needed.
2. Privileged Codes are Deprecated
The use of privileged codes is now officially deprecated and will no longer be granted.

We strongly recommend that all creators migrate their existing privileged code implementations to the newer, more robust require privileges model as soon as possible.


We appreciate your cooperation as we work to maintain a balanced and healthy ecosystem for all TheoTown players.

The TheoTown Team

User avatar
TheRealCaptain
Villager
Posts: 9
Joined: 05 Jan 2025, 23:11

Re: [1.12.30+] Limits for draft attributes and privileged code deprecation

#2

Post by TheRealCaptain »

This explains a few things. Would you mind greatly reverting these settings back? Some of like the balances the way they were. You've turn most of our cities into an utter mess.
Last edited by TheRealCaptain on 26 Oct 2025, 07:57, edited 2 times in total.

User avatar
Ostrovsk
Small-town resident
Posts: 36
Joined: 13 Oct 2023, 18:31

Re: [1.12.30+] Limits for draft attributes and privileged code deprecation

#3

Post by Ostrovsk »

TheRealCaptain wrote:
26 Oct 2025, 07:54
This explains a few things. Would you mind greatly reverting these settings back? Some of like the balances the way they were. You've turn most of our cities into an utter mess.
I absolutely agree, damn it, not a correction. All areas are de-energized and without water. For those who make one big city - an absolute minus

User avatar
Ostrovsk
Small-town resident
Posts: 36
Joined: 13 Oct 2023, 18:31

Re: [1.12.30+] Limits for draft attributes and privileged code deprecation

#4

Post by Ostrovsk »

Добрый день, можно ли его убрать? Наверное, никому это не нужно, Ведь люди скачивают то, что хотят. Как обойти или снять это ограничение?
 ! Message from: DeepL
Hello, is it possible to remove this? I guess no one needs it, since people download what they want. How can I bypass or remove this restriction?

User avatar
JustAnyone
Developer
Posts: 3655
Joined: 23 Jul 2017, 12:45
Location: Easter Island
Plugins: Showcase Store

Platform

Re: [1.12.30+] Limits for draft attributes and privileged code deprecation

#5

Post by JustAnyone »

The Influence value and Power/Water output of a plugin building are clamped (limited) by its size (each size corresponds to a curve) and its monthly price (the value on the x-axis). The output cannot exceed the curve. Increasing the monthly price simply raises the maximum possible output up to the point of the curve.

Bounds for the influences of various size buildings:
https://www.desmos.com/calculator/rdygfraq11

Bounds for power/water of various size buildings:
https://www.desmos.com/calculator/yc3ggcgmqc

User avatar
TheRealCaptain
Villager
Posts: 9
Joined: 05 Jan 2025, 23:11

Re: [1.12.30+] Limits for draft attributes and privileged code deprecation

#6

Post by TheRealCaptain »

Ostrovsk wrote:
27 Oct 2025, 03:29
TheRealCaptain wrote:
26 Oct 2025, 07:54
This explains a few things. Would you mind greatly reverting these settings back? Some of like the balances the way they were. You've turn most of our cities into an utter mess.
I absolutely agree, damn it, not a correction. All areas are de-energized and without water. For those who make one big city - an absolute minus
Exactly. ALL of my cities in all regions are a mess. I have spent years playing this game, building my cities(28) and custom regions(7). And now they need complete over-hauls(which will take massive amount of time) because someone decided something needed a change? Unacceptable.
:bb

I suspect they didn't realize the havoc this would created, or perhaps didn't care.
:calc
JustAnyone wrote:
27 Oct 2025, 12:56
The Influence value and Power/Water output of a plugin building are clamped (limited) by its size (each size corresponds to a curve) and its monthly price (the value on the x-axis). The output cannot exceed the curve. Increasing the monthly price simply raises the maximum possible output up to the point of the curve.

Bounds for the influences of various size buildings:
https://www.desmos.com/calculator/rdygfraq11

Bounds for power/water of various size buildings:
https://www.desmos.com/calculator/yc3ggcgmqc
Thank you for pointing out what we have already painfully discovered. We are not concerned about the explanations or excuses. We care about the havoc that these changes have caused and the sheer massive amounts of time it will take to correct the change you folks made without so much as an "Ooops, I'm sorry."

We are asking for a solution(revert the code parameters back to the way they were), not excuses. For the record I play the Android version.

User avatar
JustAnyone
Developer
Posts: 3655
Joined: 23 Jul 2017, 12:45
Location: Easter Island
Plugins: Showcase Store

Platform

Re: [1.12.30+] Limits for draft attributes and privileged code deprecation

#7

Post by JustAnyone »

The changes are necessary for the previously stated reasons and are here to stay.

Considering you're on Android, you may revert to an older version of the game without these limits using our official APK file: https://github.com/TheoTown-Team/transl ... ag/1.12.23
Note, that to downgrade, you will first need to uninstall the game. Please backup your game files beforehand!!!

Otherwise, you should reach out to the plugin creators of the affected plugins asking for them to be fixed.

Post Reply Previous topicNext topic

Return to “Tutorials and Documentation”