Soccerverse Wiki - Recent changes [en-gb]

Club Fundraising

Andrew.gore — Tue, 04 Aug 2026 12:16:52 GMT

Edge Cases and Important Behaviours

Main Page

Andrew.gore — Thu, 30 Jul 2026 15:43:09 GMT

Trading, Economy and Gameplay

← Older revision		Revision as of 15:43, 30 July 2026
(One intermediate revision by the same user not shown)
Line 19:		Line 19:
	[[Influence Issues]] - Issues that effect your SVC payouts in Club and Player influence		[[Influence Issues]] - Issues that effect your SVC payouts in Club and Player influence

	[[Influence Valuation]] - A 'How To' of valuing both Club and Player influence		[[Influence Valuation]] - A 'How To' of valuing both Club and Player influence when deciding if to buy or sell

	[[Player Morale - Concerns]] - Explains how the Player Morale system in Soccerverse works		[[Player Morale - Concerns]] - Explains how the Player Morale system in Soccerverse works

	[[Club Fundraising]] - An explanation of how the club fund raising feature works, to raise SVC for the club.		[[Club Fundraising]] - An explanation of how the club fund raising feature works, to raise SVC for the club.

			[[Player Rating Calculation]] - How Soccerverse calculates the player ratings - basing them on real life player performance.

			[[Player Influence Pricing]] - How the price of player influence that soccerverse sells is calculated

	=== [[Backend Game Logic]] ===		=== [[Backend Game Logic]] ===

Influence Issues

Andrew.gore — Mon, 27 Jul 2026 12:37:16 GMT

Issues - affecting Player SVC payouts

← Older revision		Revision as of 12:37, 27 July 2026
(5 intermediate revisions by the same user not shown)
Line 6:		Line 6:
	* Inactive manager		* Inactive manager
	* Manager Locked		* Manager Locked
	* ~~Low / negative~~ balance		* Negative balance
	* ~~League position~~ ''(~~bottom half of table or bad form~~)''		* Bad form ''(helps to reflect league position)''
	* Unhappy players		* Unhappy players

Line 35:		Line 35:
	* Not being played regularly		* Not being played regularly
	* In a league not good enough for the rating		* In a league not good enough for the rating
	* Club ~~league position~~ ''(~~bottom half of table or bad form~~)''		* Club in bad form ''(helps to reflect league position)''
	* Contract expiring (1 season left)		* Contract expiring (1 season left)
			* Unhappy player
	* No agent		* No agent

Club Fundraising

Andrew.gore — Sun, 26 Jul 2026 20:12:06 GMT

Influence Issues

Andrew.gore — Sun, 26 Jul 2026 16:53:11 GMT

Long term Issues

← Older revision		Revision as of 16:53, 26 July 2026
(12 intermediate revisions by the same user not shown)
Line 4:		Line 4:

	* No manager		* No manager
	* Low / negative balance
	* League position ''(bottom half of table' to 'bottom half of table or bad form)''
	* Players unhappy
	* Inactive manager		* Inactive manager
	* Manager Locked		* Manager Locked
			* Low / negative balance
			* League position ''(bottom half of table or bad form)''
			* Unhappy players


	<div style="background:#f8f9fa; border:1px solid #aaa; padding:10px; margin:10px 0;">		<div style="background:#f8f9fa; border:1px solid #aaa; padding:10px; margin:10px 0;">
	''Note: ''		''Note: You can see these issues highlighted in the Potfolio area of the webapp''
	</div>		</div>

Line 24:		Line 25:

	<div style="background:#f8f9fa; border:1px solid #aaa; padding:10px; margin:10px 0;">		<div style="background:#f8f9fa; border:1px solid #aaa; padding:10px; margin:10px 0;">
	''Note: ''		''Note: This information can be found at the Club Screen in the webapp''
	</div>		</div>

Line 33:		Line 34:
	* Underpaid contract		* Underpaid contract
	* Not being played regularly		* Not being played regularly
	* League position ''(bottom half of table' to 'bottom half of table or bad form)''
	* In a league not good enough for the rating		* In a league not good enough for the rating
			* Club league position ''(bottom half of table or bad form)''
			* Contract expiring (1 season left)
	* No agent		* No agent

	<div style="background:#f8f9fa; border:1px solid #aaa; padding:10px; margin:10px 0;">		<div style="background:#f8f9fa; border:1px solid #aaa; padding:10px; margin:10px 0;">
	''Note: ''		''Note: You can see these issues highlighted in the Potfolio area of the webapp''
	</div>		</div>

Line 45:		Line 47:
	* In a team not good enough to win cups		* In a team not good enough to win cups
	* In a team not good enough to qualify for continentals		* In a team not good enough to qualify for continentals
	* In a low league		* Not playing well in real life ''(rating will drop and wage on new contract will follow)''
	* Not playing well in real life (rating will drop and wage on new contract will follow)

	~~<div style="background:#f8f9fa; border:1px solid #aaa; padding:10px; margin:10px 0;">~~
	~~''Note:~~ ''
	~~</div>~~

Club Fundraising

Andrew.gore — Thu, 23 Jul 2026 16:19:27 GMT

3. The Fundraise Event (Contribution Phase)

Player Rating Calculation

Andrew.gore — Thu, 23 Jul 2026 15:11:51 GMT

← Older revision		Revision as of 15:11, 23 July 2026
Line 49:		Line 49:
	* limited manual adjustments under certain circumstances, where the latest covered standings no longer fairly reflect a club's real competition level.		* limited manual adjustments under certain circumstances, where the latest covered standings no longer fairly reflect a club's real competition level.

	The country multipliers run on a scale up to 100. England, France, Germany, Italy and Spain currently use 100. Examples below that level include Portugal 88, the Netherlands 83, Austria 81, Brazil 80, Belgium 79, Scotland 78, Croatia 77, Mexico 75, Argentina and Saudi Arabia 74, and the United States 70. The complete maintained list is available on the separate [[~~country_multiplier~~\|country multiplier table]] page.		The country multipliers run on a scale up to 100. England, France, Germany, Italy and Spain currently use 100. Examples below that level include Portugal 88, the Netherlands 83, Austria 81, Brazil 80, Belgium 79, Scotland 78, Croatia 77, Mexico 75, Argentina and Saudi Arabia 74, and the United States 70. The complete maintained list is available on the separate [[Country_Multiplier\|country multiplier table]] page.

	This produces a club base rating between 50 and 79, which is then used as the starting point for player skills.		This produces a club base rating between 50 and 79, which is then used as the starting point for player skills.

Player Influence Pricing

Andrew.gore — Thu, 23 Jul 2026 15:10:14 GMT

← Older revision		Revision as of 15:10, 23 July 2026
Line 32:		Line 32:

	The calculation is sometimes described as using a bell curve. It is not a mathematical bell-curve formula. It uses a maintained age table for each broad position category.		The calculation is sometimes described as using a bell curve. It is not a mathematical bell-curve formula. It uses a maintained age table for each broad position category.

			The ratings system also contains a larger age-and-position matrix for players who do not have enough qualifying match data. The four pricing curves currently contain exactly the same values as the primary-skill progression from each position category in that ratings matrix:

			* attacker pricing follows the attacker shooting progression;
			* midfielder pricing follows the midfielder passing progression;
			* defender pricing follows the defender tackling progression; and
			* goalkeeper pricing follows the goalkeeper goalkeeping progression.

			The two calculations use those values differently. The no-data ratings calculation adds age-and-skill adjustments to a club base rating to produce the player's current skills. The pricing calculation does not repeat that process and does not use the full skill matrix. It starts from the player's current overall rating and uses only the year-to-year differences in the relevant position curve to estimate future overall ratings.

	These tables describe a typical career shape:		These tables describe a typical career shape:
Line 40:		Line 49:
	* goalkeepers and defenders generally have longer modelled careers than attackers.		* goalkeepers and defenders generally have longer modelled careers than attackers.

	The player's current rating is the starting point. ~~The age table controls~~ the expected year-to-year movement ~~from that point~~; ~~it does~~ not replace the player's rating with a generic rating.		The player's current overall rating is therefore the pricing starting point. Age and position control the expected year-to-year movement and the number of modelled years remaining; they do not replace the player's current rating with a generic age-based rating.

	=== Position categories and career endpoints ===		=== Position categories and career endpoints ===

Player Rating Calculation

Andrew.gore — Thu, 23 Jul 2026 15:09:03 GMT

← Older revision		Revision as of 15:09, 23 July 2026
(2 intermediate revisions by the same user not shown)
Line 55:		Line 55:
	=== How performance skill points work ===		=== How performance skill points work ===

	The system ~~compares a~~ player's statistics with other players in the same country, division ~~and monthly period~~. Very low and very high statistical outliers are limited so that one unusual result does not dominate the calculation.		The system adds together the player's qualifying match statistics from a '''rolling 18-month window'''. It then compares those aggregated statistics with other players in the same country and division in the same ratings-calculation snapshot. Very low and very high statistical outliers are limited so that one unusual result does not dominate the calculation.

			The snapshot is labelled with the month in which the calculation is run, but that does '''not''' mean only one month of matches is used. Soccerverse normally runs and publishes the ratings calculation every six months, with each run looking back over the preceding 18 months.

	The main inputs are:		The main inputs are:
Line 75:		Line 77:

	If the player is linked to more than one club, the highest available club base rating is used. If no usable club base rating exists, the player is retired, or the player is a free agent, the fallback base rating is 50.		If the player is linked to more than one club, the highest available club base rating is used. If no usable club base rating exists, the player is retired, or the player is a free agent, the fallback base rating is 50.

			=== The age-and-position matrix for players without enough data ===

			The fallback calculation uses an age-and-position matrix. It contains a separate adjustment for each broad position category, skill and whole age. The adjustment is added to the player's club base rating.

			For example, the matrix has separate passing, shooting and tackling adjustments for attackers, midfielders and defenders, plus goalkeeping and outfield-skill adjustments for goalkeepers. The main or primary progression in each category is:

			* attacker — shooting;
			* midfielder — passing;
			* defender — tackling; and
			* goalkeeper — goalkeeping.

			This matrix is used only when a player does not have enough qualifying match data. A player with sufficient data receives performance-based skill points from the rolling 18-month statistics instead.

			The initial Player Influence pricing calculation uses age curves with exactly the same values as these four primary-skill progressions. However, pricing does not recalculate the player's individual skills or add a club base rating. It starts with the player's current overall rating and applies the year-to-year changes from the relevant position curve to estimate future ratings.

	=== Why projected ratings do not always jump straight to the calculated number ===		=== Why projected ratings do not always jump straight to the calculated number ===

Player Influence Pricing

Andrew.gore — Wed, 22 Jul 2026 22:03:47 GMT

Created page with "== The simple explanation == This article explains the initial price used when Soccerverse makes Player Influence available for sale. It does not describe the later player-to-player market price, which is set by orders in the Influence market. When Soccerverse offers Player Influence for sale, the initial price is based on an estimate of the regular wage payouts that one unit of that Influence could receive over the remainder of the player's modelled career. The calcu..."

New page

== The simple explanation ==

This article explains the initial price used when Soccerverse makes Player Influence available for sale. It does not describe the later player-to-player market price, which is set by orders in the Influence market.

When Soccerverse offers Player Influence for sale, the initial price is based on an estimate of the regular wage payouts that one unit of that Influence could receive over the remainder of the player's modelled career.

The calculation uses three main player details:

* the player's current overall rating;
* the player's current age; and
* the player's main position category.

In simple terms, the system:

# estimates how the player's rating may rise or fall as they get older;
# converts each estimated rating into a wage;
# estimates the Player Influence payout from those wages;
# adds the estimated payouts from the remaining modelled career;
# divides the total across 1,000,000 units of Player Influence; and
# adds a 10% markup to produce the initial price per Influence.

<pre>
Initial price per Player Influence =
estimated remaining regular-wage payouts
÷ 1,000,000 Influence
+ 10% markup
</pre>

The result is truncated to a whole number.

=== What the “bell curve” means ===

The calculation is sometimes described as using a bell curve. It is not a mathematical bell-curve formula. It uses a maintained age table for each broad position category.

These tables describe a typical career shape:

* younger players may improve;
* players reach a modelled peak at different ages;
* ratings may then decline as players get older; and
* goalkeepers and defenders generally have longer modelled careers than attackers.

The player's current rating is the starting point. The age table controls the expected year-to-year movement from that point; it does not replace the player's rating with a generic rating.

=== Position categories and career endpoints ===

The pricing model uses four broad categories:

<pre>
Position category Included positions Curve endpoint
----------------- ------------------------------------ --------------
Goalkeeper GK 40
Defender LB, CB, RB 36
Midfielder DML, DMC, DMR, LM, CM, RM, 35
AML, AM, AMR
Attacker FL, FC, FR 33
</pre>

A left-back therefore uses the '''defender''' curve. A centre-forward — encoded as FC in Soccerverse and also commonly written CF — uses the '''attacker''' curve.

For the game-sale export, a player at or beyond the category's endpoint is treated as retired and is not given an initial sale price. This means the last age that receives a price is currently:

<pre>
Attacker 32
Midfielder 34
Defender 35
Goalkeeper 39
</pre>

These are pricing-model assumptions. A player's real-life retirement can happen earlier or later.

== Worked example: 25-year-old attacker rated 90 ==

For an attacker who is currently 25 and rated 90, the career table projects the following rating path:

<pre>
Age Modelled rating
--- ---------------
25 90
26 90
27 91
28 91
29 90
30 89
31 87
32 86
33 85
</pre>

The pricing calculator converts each year's rating into a wage and estimates the Player Influence distribution from 76 wage payments per year.

The resulting calculation is:

<pre>
Estimated regular-wage distributions: 4,146,552,400
Divided by 1,000,000 Influence: 4,146.5524
After the 10% markup: 4,561.20764
Truncated initial price: 4,561
</pre>

So the initial Soccerverse sale price is '''4,561 per Player Influence''' under the current assumptions.

== Why age and position change the price ==

Two players with the same current rating can receive different initial prices.

A younger player normally has more modelled wage-paying years remaining. Position also matters because each category has a different career path and endpoint.

For example, using the same current age of 25 and rating of 90:

<pre>
Position Calculated initial price
------------ ------------------------
Attacker 4,561
Midfielder 5,285
Defender 6,655
Goalkeeper 9,594
</pre>

This does not mean that one position is automatically a better purchase. It only shows the effect of the modelled remaining career and rating path. Real ratings, wages, contracts, performances and retirement can develop differently.

== Detailed explanation ==

=== Step 1: calculate the player's current age ===

Age is calculated from the player's date of birth using the current date. Whole ages are used; the calculation changes after the player's birthday rather than interpolating through the year.

=== Step 2: select the age-progression table ===

The player's main position selects one of four maintained tables.

The values below are cumulative career-shape values. The difference between one age and the next gives the projected rating movement for the next year.

<pre>
Attackers
16:0 17:0 18:1 19:2 20:3 21:4 22:4 23:5 24:5
25:6 26:6 27:7 28:7 29:6 30:5 31:3 32:2 33:1

Midfielders
16:0 17:0 18:1 19:2 20:2 21:3 22:3 23:4 24:4
25:5 26:6 27:6 28:5 29:4 30:4 31:3 32:3 33:2
34:1 35:0

Defenders
16:0 17:1 18:1 19:2 20:3 21:4 22:5 23:6 24:6
25:7 26:7 27:8 28:8 29:8 30:8 31:8 32:7 33:6
34:4 35:3 36:1

Goalkeepers
16:0 17:0 18:1 19:2 20:2 21:3 22:3 23:4 24:4
25:5 26:5 27:6 28:6 29:6 30:6 31:6 32:6 33:6
34:6 35:5 36:5 37:4 38:3 39:2 40:1
</pre>

For example, an attacker's table value changes from 6 at age 26 to 7 at age 27, so the model adds one rating point for age 27. It changes from 7 at age 28 to 6 at age 29, so the model removes one point for age 29.

A projected rating is capped at 99.

=== Step 3: convert each projected rating into a wage ===

For a rating below 60:

<pre>
Wage per match = 5 × rating × 50,000
</pre>

For a rating of 60 or above:

<pre>
Start at 300 when rating = 60
For every rating point above 60, multiply by 1.2
Wage per match = resulting amount × 50,000
</pre>

The implementation uses integer arithmetic at each step, so it can differ slightly from calculating the complete exponential formula with decimals and rounding only once at the end.

=== Step 4: estimate the annual regular-wage distribution ===

The current assumptions use 76 wage payments per year and distribute 0.2% of player wages across Player Influence holders:

<pre>
Annual wage = wage per match × 76

Estimated annual Player Influence distribution =
annual wage × 0.002
</pre>

This is the total estimated regular-wage distribution across all 1,000,000 units of that player's Influence.

=== Step 5: add the remaining modelled years ===

The annual distributions are added from the player's current age through the final year in the selected position curve.

<pre>
Total estimated distribution =
sum of each modelled year's regular-wage distribution
</pre>

The low-level projection includes the curve's endpoint year in this sum. Separately, the game-sale export does not issue a price once the player is already at that endpoint age.

=== Step 6: calculate the initial price per Influence ===

<pre>
Estimated value per Influence =
total estimated distribution ÷ 1,000,000

Initial Soccerverse sale price =
truncate(estimated value per Influence × 1.10 × price multiplier)
</pre>

The current price multiplier is 1.0, so it does not change the result. The calculated minimum is 1, although a value of 1 is not added as an active initial sale price by the export.

== Initial sale price versus market price ==

This calculation sets the initial sell order when Soccerverse makes Player Influence available. It does not permanently fix the market value.

Afterwards, users can place their own buy and sell orders. The traded price can therefore be higher or lower than the calculated initial Soccerverse price. When users buy Player Influence from the Soccerverse sell order, the SVC spent is burned rather than paid to the Soccerverse team.

== Important limitations ==

* The calculation is an estimate, not a promise of future payouts or investment returns.
* It estimates the regular wage-related distribution used by this pricing formula; other possible player-influencer payouts are not added to the initial-price calculation.
* Actual player wages and payouts can differ because ratings change and in-game contracts can be negotiated.
* Current rating, age and main position all affect the result.
* The age curves are maintained assumptions, not predictions about one specific player's real career.
* Players can retire earlier or later than the modelled endpoint.
* The initial price can be recalculated when player ratings are updated.
* User-created orders determine the later market price.
* Pricing constants and age curves can be adjusted under exceptional or changed game-design circumstances.

== Public sources ==

* https://guide.soccerverse.com/influence/player-influence/

Country Multiplier

Andrew.gore — Wed, 22 Jul 2026 22:01:11 GMT

Created page with "== What the multiplier does == A country multiplier helps place clubs from different domestic football systems onto one global scale. It is applied after a club has been positioned within its own country and absolute division using points per game. <pre> Global club score = country-and-division score × (country multiplier ÷ 100) </pre> A multiplier of 100 leaves the country-and-division score unchanged. A lower value reduces it before all clubs are scaled into the f..."

New page

== What the multiplier does ==

A country multiplier helps place clubs from different domestic football systems onto one global scale. It is applied after a club has been positioned within its own country and absolute division using points per game.

<pre>
Global club score = country-and-division score × (country multiplier ÷ 100)
</pre>

A multiplier of 100 leaves the country-and-division score unchanged. A lower value reduces it before all clubs are scaled into the final 50–79 club base-rating range.

The multiplier does '''not''' directly become a player rating, and it does not mean that every club or player from one country receives the same rating. Domestic division and club performance still matter.

For the complete process, see [[player_ratings|How Player Ratings Are Calculated]].

== Current country multiplier table ==

{| class="wikitable sortable"
! Code !! Country !! Multiplier
|-
| ALB || Albania || 49
|-
| DZA || Algeria || 56
|-
| AND || Andorra || 39
|-
| AGO || Angola || 36
|-
| ARG || Argentina || 74
|-
| ARM || Armenia || 47
|-
| AUS || Australia || 53
|-
| AUT || Austria || 81
|-
| AZE || Azerbaidjan || 57
|-
| BHR || Bahrain || 42
|-
| BGD || Bangladesh || 44
|-
| BLR || Belarus || 50
|-
| BEL || Belgium || 79
|-
| BEN || Benin || 21
|-
| BTN || Bhutan || 22
|-
| BOL || Bolivia || 56
|-
| BIH || Bosnia || 52
|-
| BWA || Botswana || 25
|-
| BRA || Brazil || 80
|-
| BGR || Bulgaria || 67
|-
| BFA || Burkina Faso || 21
|-
| BDI || Burundi || 15
|-
| KHM || Cambodia || 30
|-
| CMR || Cameroon || 21
|-
| CAN || Canada || 48
|-
| CHL || Chile || 62
|-
| CHN || China || 60
|-
| COL || Colombia || 62
|-
| COG || Congo || 22
|-
| COD || Congo DR || 37
|-
| CRI || Costa Rica || 50
|-
| HRV || Croatia || 77
|-
| CUB || Cuba || 10
|-
| CYP || Cyprus || 61
|-
| CZE || Czech Republic || 69
|-
| DNK || Denmark || 71
|-
| DOM || Dominican Republic || 25
|-
| ECU || Ecuador || 59
|-
| EGY || Egypt || 64
|-
| SLV || El Salvador || 44
|-
| ENG || England || 100
|-
| EST || Estonia || 47
|-
| SWZ || Eswatini || 15
|-
| ETH || Ethiopia || 26
|-
| FRO || Faroe Islands || 41
|-
| FJI || Fiji || 42
|-
| FIN || Finland || 50
|-
| FRA || France || 100
|-
| GAB || Gabon || 26
|-
| GMB || Gambia || 22
|-
| GEO || Georgia || 51
|-
| DEU || Germany || 100
|-
| GHA || Ghana || 43
|-
| GIB || Gibraltar || 41
|-
| GRC || Greece || 70
|-
| GTM || Guatemala || 47
|-
| GIN || Guinea || 28
|-
| HTI || Haiti || 24
|-
| HND || Honduras || 44
|-
| HKG || Hong Kong || 46
|-
| HUN || Hungary || 68
|-
| ISL || Iceland || 42
|-
| IND || India || 50
|-
| IDN || Indonesia || 48
|-
| IRN || Iran || 57
|-
| IRQ || Iraq || 43
|-
| IRL || Ireland || 43
|-
| ISR || Israel || 61
|-
| ITA || Italy || 100
|-
| CIV || Ivory Coast || 29
|-
| JAM || Jamaica || 26
|-
| JPN || Japan || 61
|-
| JOR || Jordan || 41
|-
| KAZ || Kazakhstan || 57
|-
| KEN || Kenya || 22
|-
| KOS || Kosovo || 48
|-
| KWT || Kuwait || 46
|-
| KGZ || Kyrgyzstan || 44
|-
| LAO || Laos || 36
|-
| LVA || Latvia || 50
|-
| LBN || Lebanon || 49
|-
| LSO || Lesotho || 15
|-
| LBR || Liberia || 13
|-
| LBY || Libya || 41
|-
| LTU || Lithuania || 51
|-
| LUX || Luxembourg || 43
|-
| MKD || Macedonia || 48
|-
| MWI || Malawi || 16
|-
| MYS || Malaysia || 52
|-
| MLI || Mali || 22
|-
| MLT || Malta || 47
|-
| MRT || Mauritania || 29
|-
| MUS || Mauritius || 29
|-
| MEX || Mexico || 75
|-
| MDA || Moldova || 55
|-
| MNG || Mongolia || 0
|-
| MNE || Montenegro || 44
|-
| MAR || Morocco || 58
|-
| MMR || Myanmar || 42
|-
| NAM || Namibia || 25
|-
| NPL || Nepal || 23
|-
| NLD || Netherlands || 83
|-
| NZL || New Zealand || 48
|-
| NIC || Nicaragua || 28
|-
| NGA || Nigeria || 31
|-
| NIR || Northern Ireland || 43
|-
| NOR || Norway || 63
|-
| OMN || Oman || 41
|-
| PAN || Panama || 42
|-
| PRY || Paraguay || 61
|-
| PER || Peru || 57
|-
| PHL || Philippines || 30
|-
| POL || Poland || 66
|-
| PRT || Portugal || 88
|-
| QAT || Qatar || 64
|-
| ROU || Romania || 62
|-
| RUS || Russia || 81
|-
| RWA || Rwanda || 25
|-
| SMR || San Marino || 30
|-
| SAU || Saudi Arabia || 74
|-
| SCO || Scotland || 78
|-
| SEN || Senegal || 27
|-
| SRB || Serbia || 73
|-
| SGP || Singapore || 40
|-
| SVK || Slovakia || 58
|-
| SVN || Slovenia || 56
|-
| SOM || Somalia || 7
|-
| ZAF || South Africa || 62
|-
| KOR || South Korea || 61
|-
| ESP || Spain || 100
|-
| SDN || Sudan || 40
|-
| SWE || Sweden || 64
|-
| CHE || Switzerland || 73
|-
| SYR || Syria || 36
|-
| TJK || Tajikistan || 37
|-
| TZA || Tanzania || 40
|-
| THA || Thailand || 52
|-
| TGO || Togo || 27
|-
| TTO || Trinidad And Tobago || 26
|-
| TUN || Tunisia || 55
|-
| TUR || Turkey || 81
|-
| TKM || Turkmenistan || 29
|-
| USA || USA || 70
|-
| UGA || Uganda || 29
|-
| UKR || Ukraine || 81
|-
| ARE || United Arab Emirates || 66
|-
| URY || Uruguay || 62
|-
| UZB || Uzbekistan || 56
|-
| VEN || Venezuela || 52
|-
| VNM || Vietnam || 48
|-
| WAL || Wales || 40
|-
| YEM || Yemen || 22
|-
| ZMB || Zambia || 29
|-
| ZWE || Zimbabwe || 21
|}

== Important notes ==

* These values are maintained inputs rather than permanent rankings.
* They can be adjusted when league strength, competition structure or data coverage changes.
* The calculation uses absolute division numbers; a country without a covered Division 1 does not automatically promote Division 2 into the top division band.
* A missing multiplier behaves as zero in the current calculation and will normally cause the affected club to receive the minimum base rating of 50.
* Club base ratings may also receive limited manual adjustments under certain circumstances where the available standings no longer fairly represent the club’s real competition level.

Player Rating Calculation

Andrew.gore — Wed, 22 Jul 2026 21:58:48 GMT

Show changes

Player Rating Calculation

Andrew.gore — Wed, 22 Jul 2026 21:46:49 GMT

Created page with "# How Player Ratings Are Calculated > Draft for review. This article separates the easy explanation from the full technical detail. It describes the current `player_ratings_v2` and `baseratings` calculations found in the Soccerverse source repositories. ## The simple explanation Every player has four skill ratings: - **Goalkeeping** - **Tackling** - **Passing** - **Shooting** A player's **overall rating is their highest skill rating**. It is not an average of all fo..."

New page

# How Player Ratings Are Calculated

> Draft for review. This article separates the easy explanation from the full technical detail. It describes the current `player_ratings_v2` and `baseratings` calculations found in the Soccerverse source repositories.

## The simple explanation

Every player has four skill ratings:

- **Goalkeeping**
- **Tackling**
- **Passing**
- **Shooting**

A player's **overall rating is their highest skill rating**. It is not an average of all four skills.

For example, a player with these skills:

```text
Goalkeeping 50
Tackling 72
Passing 76
Shooting 81
Overall 81
```

has an overall rating of 81 because shooting is their strongest skill.

### Where the ratings come from

The calculation has two main parts:

1. **The strength of the player's real-life club** provides a starting or "base" rating.
2. **The player's own recent real-life performances** add skill points for passing, shooting, tackling or goalkeeping.

In simple terms:

```text
Player skill rating = club base rating + performance skill points
```

Some adjustments are then applied for the player's position, and every final skill rating is kept between 50 and 99.

### Why club strength matters

A player's statistics must be viewed in context. Performing well for a strong club in a strong competition is not treated exactly the same as recording similar numbers at a much lower standard.

The Base Ratings service estimates club strength using league results and competition context. It uses:

- points per game;
- the club's position relative to other clubs in the same division;
- the absolute division level;
- the country's strength multiplier; and
- a small list of documented manual overrides for clubs whose latest covered standings no longer reflect their real competition level.

The country multipliers run on a scale up to 100. England, France, Germany, Italy and Spain currently use 100. Examples below that level include Portugal 88, the Netherlands 83, Austria 81, Brazil 80, Belgium 79, Scotland 78, Croatia 77, Mexico 75, Argentina and Saudi Arabia 74, and the United States 70.

This produces a club base rating between 50 and 79, which is then used as the starting point for player skills.

### How performance skill points work

The system compares a player's statistics with other players in the same country, division and monthly period. Very low and very high statistical outliers are limited so that one unusual result does not dominate the calculation.

The main inputs are:

- **Passing:** passes, key passes and successful dribbles per minute.
- **Shooting:** goals, shots on target, assists and minutes played.
- **Tackling:** duels won, interceptions, tackles, blocks and minutes played.
- **Goalkeeping:** currently based primarily on qualifying minutes played as a goalkeeper.

A player normally needs at least **300 qualifying minutes** before the match-data calculation is used.

### What happens when there is not enough data?

If a player does not have enough qualifying match data, the system does not invent statistics. It instead estimates the player's skills from:

- their club's base rating;
- their age; and
- their position.

If the player is linked to more than one club, the highest available club base rating is used. If no usable club base rating exists, the player is retired, or the player is a free agent, the fallback base rating is 50.

### Why projected ratings do not always jump straight to the calculated number

For existing players, large movements are softened. Each skill moves towards its newly calculated target, but a very large change is not always applied all at once.

This reduces sudden extreme changes caused by a new data source, a small sample, a transfer or a major change in competition level.

### Example: player with match data from two clubs

Suppose a player records 600 qualifying minutes for Club A and 300 for Club B. After the club-level calculations, their tackling rating is 79 for Club A and 72 for Club B.

The combined rating is weighted by minutes:

```text
((79 × 600) + (72 × 300)) ÷ 900 = 76.67
Rounded tackling rating = 77
```

The club where the player played more minutes therefore has more influence on the result.

### Example: player without enough match data

Suppose a 30-year-old defender has a club base rating of 64. The age-and-position table gives this example defender:

```text
Tackling adjustment +8
Passing adjustment +2
Shooting adjustment +3
```

The estimated skills are:

```text
Goalkeeping 50
Tackling 64 + 8 = 72
Passing 64 + 2 = 66
Shooting 64 + 3 = 67
Overall 72
```

The overall is 72 because tackling is the highest skill.

## Detailed explanation

### Current and projected ratings

On SoccerRatings, **current** and **projected** refer to different stored rating snapshots:

- The current rating is the historical/current Soccerverse rating snapshot.
- The projected rating is the result currently calculated for a future ratings update.

The website displays these stored results; it does not calculate them separately in the browser.

### Verified club base-rating formula

The Base Ratings calculation uses the most recent sufficiently complete season available for each club. Its only performance input is:

```text
Points per game = league points ÷ matches played
```

It does not use goals, recent form, squad value, player reputation or market data.

Within each country and division, the 5th and 95th percentile points-per-game values are used to reduce the effect of outliers. The club is placed within a division score band:

```text
Division 1: 700–1000
Division 2: 490–700
Division 3: 343–490
Division 4: 240.1–343
```

For division number `d`, the general formula is:

```text
maximum division score = 1000 × 0.7^(d − 1)
minimum division score = maximum division score × 0.7
```

The club's points per game is limited to the percentile range and converted into its position within that division band:

```text
position =
(clipped PPG − 5th-percentile PPG)
÷ (95th-percentile PPG − 5th-percentile PPG)

country score =
minimum division score
+ position × (maximum division score − minimum division score)
```

The country multiplier is then applied:

```text
global score = country score × (country multiplier ÷ 100)
```

Finally, the global scores from the current calculation run are scaled into the 50–79 base-rating range:

```text
effective score = max(0, global score − 200)
effective maximum = strongest global score in the run − 200

base rating =
round(50 + (effective score ÷ effective maximum) × 29)

base rating is limited to 50–79
```

A missing country multiplier behaves as zero. A club without usable standings, or whose strength falls below the global floor, receives the minimum base rating of 50. The strongest calculated club in each run anchors rating 79, so the final scale is relative to that run rather than to a permanently hardcoded maximum club.

### Statistical normalization

For each statistic, the system finds configured low and high percentile values among the comparison group. The player's value is limited to that range and converted into points:

```text
clipped value = value limited to the low/high percentile range

component points =
(clipped value - low value)
÷ (high value - low value)
× maximum points for that component
```

If the comparison range is missing or has no width, that component contributes zero points.

### Skill-point weights

#### Passing — maximum 20 skill points

```text
Passes per minute up to 16 points
Key passes per minute up to 2 points
Successful dribbles per minute up to 2 points
```

#### Shooting — maximum 20 skill points

```text
Goals per minute up to 8 points
Minutes played up to 6 points
Shots on target per minute up to 4 points
Assists per minute up to 2 points
```

#### Tackling — maximum 20 skill points

```text
Duels-won percentage up to 12 points
Minutes played up to 4 points
Interceptions per minute up to 2 points
Tackles per minute up to 1 point
Blocks per minute up to 1 point
```

The duels-won percentage is set to zero where fewer than 10 duels are recorded for that row.

#### Goalkeeping — maximum 16 skill points

For recognised goalkeepers, the current calculation awards goalkeeping points from normalized qualifying minutes. Non-goalkeepers receive a goalkeeping rating of 50.

### Final match-data skill formula

For most skills:

```text
Final skill rating =
club base rating
+ calculated skill points
+ any positional adjustment
```

The result is limited to the range 50–99.

Current positional adjustments include:

- Goalkeepers receive a 15-point reduction to passing, shooting and tackling.
- Players whose main position is left-back, centre-back or right-back receive a 5-point passing reduction.
- A non-goalkeeper's goalkeeping rating remains 50 rather than having the club base added to it.

### Combining records from more than one club

Each skill is combined separately using minutes played:

```text
Combined skill =
round(sum(club skill rating × club minutes) ÷ total club minutes)
```

The overall is then:

```text
Overall = maximum of goalkeeping, tackling, passing and shooting
```

### No-data calculation

Where qualifying match data is unavailable, the system selects an age-and-position adjustment from a lookup table.

For an outfield player:

```text
Goalkeeping = 50
Tackling = club base + age/position tackling adjustment
Passing = club base + age/position passing adjustment
Shooting = club base + age/position shooting adjustment
Overall = highest skill
```

For a goalkeeper, the age adjustment is applied to goalkeeping, while the other three skills also receive the goalkeeper's 15-point positional reduction.

The lookup uses whole ages and does not interpolate between birthdays. Ages outside a table use the first or last available adjustment.

### Limiting large movements

For an existing player, each new target skill is compared with the current skill.

If the difference is five points or fewer, the target is accepted. For larger differences:

```text
Allowed movement = 5 + ceil((absolute difference - 5) × 0.5)
```

The skill moves by that allowed amount towards the target. Overall is then recalculated from the adjusted skills rather than limited separately.

Example: current shooting 60, calculated target 77:

```text
Difference = 17
Allowed movement = 5 + ceil((17 - 5) × 0.5)
= 11
Projected shooting = 60 + 11
= 71
```

### Important limitations and data-quality notes

- A projection is not the live Soccerverse rating until a rating update is applied by the game.
- Players with fewer than 300 qualifying minutes normally use the no-data route.
- Missing club mappings, retired status or free-agent status can cause the base-50 fallback.
- Existing-player movement limits can make the displayed projection different from the raw statistical target.
- Real-life data providers can correct or update match statistics after matches.
- Country strength is applied using the maintained multiplier table in the separate Base Ratings repository.
- A missing multiplier behaves as zero and can therefore cause a club to receive the rating floor.

## Sources for verification

Public pages:

- https://soccerratings.org/
- https://baseratings.soccerratings.org/
- https://soccerratings.org/player/184

Current calculation source reviewed:

- `baseratings/country_multipliers.csv`
- `baseratings/docs/base-ratings-calculation.md`
- `baseratings/scripts/calculate-new-base-ratings.ts`
- `player_ratings_v2/config/skill_config.yaml`
- `player_ratings_v2/processors/skill_calculator.py`
- `player_ratings_v2/processors/season_player_builder.py`
- `player_ratings_v2/processors/nodata_handler.py`
- `player_ratings_v2/processors/skills/`
- `player_ratings_v2/utils/normalization.py`
- `player_ratings_v2/utils/rating_movement.py`

---

# Editorial notes before publication

1. Decide whether the complete 154-country multiplier table should be reproduced on the wiki or summarized with examples.
2. Confirm whether the current goalkeeping model being minutes-led is intended for public emphasis.
3. Decide whether positional penalties should be shown in the public technical section or summarized more generally.
4. Resolve a documentation contradiction: the community summary says there are no manual adjustments, while the source-of-truth calculation document confirms a small post-calculation override list.
5. Replace private repository references with suitable public wiki citations where appropriate.

← Older revision		Revision as of 12:16, 4 August 2026
(One intermediate revision by the same user not shown)
Line 22:		Line 22:
	* If the club is '''in debt''', the fundraise '''bypasses voting entirely''' — a fundraise event is created immediately and goes straight to the contribution phase.		* If the club is '''in debt''', the fundraise '''bypasses voting entirely''' — a fundraise event is created immediately and goes straight to the contribution phase.

	The amount of new influence to be created is calculated as a percentage (basis points) of the club's current ~~outstanding~~ influence, currently 5% (configured by the <code>seasonend-dilution-bp</code> parameter). The minimum raise is zero.		The amount of new influence to be created is calculated as a percentage (basis points) of the club's current circulating influence, currently 5% (configured by the <code>seasonend-dilution-bp</code> parameter). The minimum raise is zero.

	==== B. User-Proposed (Influencer Initiative) ====		==== B. User-Proposed (Influencer Initiative) ====
Line 28:		Line 28:
	Any influencer can propose a fundraise if they meet two requirements:		Any influencer can propose a fundraise if they meet two requirements:

	* They must own at least a certain '''relative percentage''' of all ~~outstanding~~ club influence, currently 5% (configured by the <code>dilution-min-bps</code> parameter).		* They must own at least a certain '''relative percentage''' of all circulating club influence, currently 5% (configured by the <code>dilution-min-bps</code> parameter).
	* Enough time must have passed since the '''last user-proposed fundraise vote''' for that club, currently 70 days (configured by <code>min-seconds-between-dilution-votes</code>).		* Enough time must have passed since the '''last user-proposed fundraise vote''' for that club, currently 70 days (configured by <code>min-seconds-between-dilution-votes</code>).

	The proposing influencer specifies:		The proposing influencer specifies:

	* '''<code>n</code>''': How much new influence to create, between 1 and a maximum, which is a percentage of ~~outstanding~~ influence, currently 20% (configured by <code>dilution-max-bps</code>).		* '''<code>n</code>''': How much new influence to create, between 1 and a maximum, which is a percentage of circulating influence, currently 20% (configured by <code>dilution-max-bps</code>).
	* '''<code>mr</code>''' (minimum raise): The minimum amount of SVC that must be raised. If the total contributions fall short of this, the fundraise fails and all SVC is refunded.		* '''<code>mr</code>''' (minimum raise): The minimum amount of SVC that must be raised. If the total contributions fall short of this, the fundraise fails and all SVC is refunded.

Line 96:		Line 96:
	\| <code>dilution-min-bps</code> \|\| Minimum influence holding (in basis points) required to propose a fundraise \|\| 500		\| <code>dilution-min-bps</code> \|\| Minimum influence holding (in basis points) required to propose a fundraise \|\| 500
	\|-		\|-
	\| <code>dilution-max-bps</code> \|\| Maximum new influence as basis points of ~~outstanding~~ supply \|\| 2000		\| <code>dilution-max-bps</code> \|\| Maximum new influence as basis points of circulating supply \|\| 2000
	\|-		\|-
	\| <code>dilution-coins-multiplier-bps</code> \|\| Multiplier applied to contributors' actually spent SVC when crediting the club and checking the minimum raise \|\| 1,000,000 (100×)		\| <code>dilution-coins-multiplier-bps</code> \|\| Multiplier applied to contributors' actually spent SVC when crediting the club and checking the minimum raise \|\| 1,000,000 (100×)
Line 108:		Line 108:
	\| <code>min-seconds-between-dilution-votes</code> \|\| Cooldown between user-proposed fundraise votes per club \|\| 70 * days		\| <code>min-seconds-between-dilution-votes</code> \|\| Cooldown between user-proposed fundraise votes per club \|\| 70 * days
	\|-		\|-
	\| <code>seasonend-dilution-bp</code> \|\| New influence to create at season end, as basis points of ~~outstanding~~ \|\| 500		\| <code>seasonend-dilution-bp</code> \|\| New influence to create at season end, as basis points of circulating \|\| 500
	\|}		\|}

Line 114:		Line 114:

	* '''No contributors''': If nobody contributes to a fundraise event, it fails. No influence is created and no money changes hands.		* '''No contributors''': If nobody contributes to a fundraise event, it fails. No influence is created and no money changes hands.
	* '''Zero price''': If the total contributions are less than the amount of influence, the effective price rounds down to 0. In this case, the single largest (and earliest) contributor gets '''all the influence for free''' (but still gets their SVC refunded — effectively free influence).
	* '''Minimum raise not met''': Even if many users contribute, if the total SVC that would actually be spent (after rounding) falls below the minimum raise, the event fails. All SVC is refunded.		* '''Minimum raise not met''': Even if many users contribute, if the total SVC that would actually be spent (after rounding) falls below the minimum raise, the event fails. All SVC is refunded.
	* '''Individual rounding''': Because influence is bought in whole units at a rounded-down price, it is possible that less influence is sold than was available. E.g. with 1 influence available and a price of 3 SVC/influence, three contributors each putting in 1 SVC would each be able to buy 0 influence (1 / 3 = 0), so the raise would fail despite total bids exceeding the minimum.		* '''Individual rounding''': Because influence is bought in whole units at a rounded-down price, it is possible that less influence is sold than was available. E.g. with 1 influence available and a price of 3 SVC/influence, three contributors each putting in 1 SVC would each be able to buy 0 influence (1 / 3 = 0), so the raise would fail despite total bids exceeding the minimum.
	* '''Beyond base supply''': Fundraising can push the ~~total outstanding~~ influence above the base supply of 1,000,000. This is intentional — fundraising is how supply grows.		* '''Beyond base supply''': Fundraising can push the max supply of influence above the base supply of 1,000,000. This is intentional — fundraising is how supply grows.
	* '''Voting power for proposals''': The quorum for proposing fundraises is always based on '''base supply''' (1,000,000) if fewer influence than that is minted. This prevents a small influencer from proposing a fundraise when very little influence is in circulation.		* '''Voting power for proposals''': The quorum for proposing fundraises is always based on '''base supply''' (1,000,000) if fewer influence than that is minted. This prevents a small influencer from proposing a fundraise when very little influence is in circulation.
	* '''End-of-season proposals for clubs in debt start immediately''': Unlike user-proposed ones, they have no "upcoming" phase and go straight to voting (<code>start_time = now + 1 second</code>). They also cannot be amended.		* '''End-of-season proposals for clubs in debt start immediately''': Unlike user-proposed ones, they have no "upcoming" phase and go straight to voting (<code>start_time = now + 1 second</code>). They also cannot be amended.

← Older revision		Revision as of 20:12, 26 July 2026
Line 68:		Line 68:
	* Users can '''top up''' their contribution at any time while the event is active. Multiple contributions from the same user are combined into one entry.		* Users can '''top up''' their contribution at any time while the event is active. Multiple contributions from the same user are combined into one entry.
	* The contributed SVC is '''reserved''' (locked) from the user's balance immediately.		* The contributed SVC is '''reserved''' (locked) from the user's balance immediately.
			* The club funding is multiplied by the <code>dilution-coins-multiplier-bps</code> parameter. At the current value of 1,000,000 basis points, each 1 SVC actually spent by contributors credits 100 SVC to the club. The minimum raise is checked after applying this multiplier.

	=== 4. Settlement (After the End Time) ===		=== 4. Settlement (After the End Time) ===
Line 76:		Line 77:
	# '''Success check''': The event succeeds if:		# '''Success check''': The event succeeds if:
	#* At least one user contributed, '''and'''		#* At least one user contributed, '''and'''
	#* <code>shares_sold × price ≥ minimum_raise</code>		#* <code>multiplier × shares_sold × price / 10,000 ≥ minimum_raise</code> (currently equivalent to <code>100 × shares_sold × price ≥ minimum_raise</code>)
	#: If the event '''fails''', all SVC is refunded and no influence is created.		#: If the event '''fails''', all SVC is refunded and no influence is created.
	# '''Influence distribution''' (if successful): Contributors are processed in order of '''largest contribution first''', then '''earliest contribution''' as a tie-breaker. Each contributor buys as many whole influence as their contribution allows at the effective price:		# '''Influence distribution''' (if successful): Contributors are processed in order of '''largest contribution first''', then '''earliest contribution''' as a tie-breaker. Each contributor buys as many whole influence as their contribution allows at the effective price:
Line 83:		Line 84:
	#* <code>refund = contribution - SVC_spent</code>		#* <code>refund = contribution - SVC_spent</code>
	#: The refund is '''not taken from the user's balance''' — only the actually spent SVC is deducted.		#: The refund is '''not taken from the user's balance''' — only the actually spent SVC is deducted.
	# '''Club gets the money''': ~~The total SVC raised (all contributions minus all~~ refunds~~) is transferred to~~ the club~~'s balance as a~~ '''~~"cash injection"~~''' (visible on the club's balance sheet).		# '''Club gets the money''': Contributors spend the unmultiplied amount after refunds, while the club receives that amount multiplied by <code>dilution-coins-multiplier-bps / 10,000</code> — currently '''100×'''. The resulting income is visible on the club's balance sheet as <code>dilution_income</code>.
	# '''Contributors get influence''': New influence is minted and credited to contributors' balances. This is '''new influence''' — it increases the total supply above the base supply of 1,000,000.		# '''Contributors get influence''': New influence is minted and credited to contributors' balances. This is '''new influence''' — it increases the total supply above the base supply of 1,000,000.

Line 96:		Line 97:
	\|-		\|-
	\| <code>dilution-max-bps</code> \|\| Maximum new influence as basis points of outstanding supply \|\| 2000		\| <code>dilution-max-bps</code> \|\| Maximum new influence as basis points of outstanding supply \|\| 2000
			\|-
			\| <code>dilution-coins-multiplier-bps</code> \|\| Multiplier applied to contributors' actually spent SVC when crediting the club and checking the minimum raise \|\| 1,000,000 (100×)
	\|-		\|-
	\| <code>dilution-upcoming-seconds</code> \|\| Duration of the "upcoming" (amendable) phase \|\| 7 * days		\| <code>dilution-upcoming-seconds</code> \|\| Duration of the "upcoming" (amendable) phase \|\| 7 * days
Line 116:		Line 119:
	* '''Beyond base supply''': Fundraising can push the total outstanding influence above the base supply of 1,000,000. This is intentional — fundraising is how supply grows.		* '''Beyond base supply''': Fundraising can push the total outstanding influence above the base supply of 1,000,000. This is intentional — fundraising is how supply grows.
	* '''Voting power for proposals''': The quorum for proposing fundraises is always based on '''base supply''' (1,000,000) if fewer influence than that is minted. This prevents a small influencer from proposing a fundraise when very little influence is in circulation.		* '''Voting power for proposals''': The quorum for proposing fundraises is always based on '''base supply''' (1,000,000) if fewer influence than that is minted. This prevents a small influencer from proposing a fundraise when very little influence is in circulation.
	* '''End-of-season proposals start immediately''': Unlike user-proposed ones, they have no "upcoming" phase and go straight to voting (<code>start_time = now + 1 second</code>). They also cannot be amended.		* '''End-of-season proposals for clubs in debt start immediately''': Unlike user-proposed ones, they have no "upcoming" phase and go straight to voting (<code>start_time = now + 1 second</code>). They also cannot be amended.
	* '''Balance sheet entries''': For the club, the fundraise creates a <code>~~cash_injection~~</code> entry. For the user, it creates a fundraise entry under their balance sheet, and a fundraise entry in the influence transaction history.		* '''Balance sheet entries''': For the club, the fundraise creates a <code>dilution_income</code> entry. For the user, it creates a fundraise entry under their balance sheet, and a fundraise entry in the influence transaction history.

	== User-Facing Move Summary ==		== User-Facing Move Summary ==

← Older revision		Revision as of 16:19, 23 July 2026
(9 intermediate revisions by the same user not shown)
Line 8:		Line 8:

	# '''Rescuing clubs in debt.''' At the end of each season, clubs with a negative balance automatically get a fundraise event started immediately (no vote needed). This creates new influence for SVC, injecting cash into the club so it can recover.		# '''Rescuing clubs in debt.''' At the end of each season, clubs with a negative balance automatically get a fundraise event started immediately (no vote needed). This creates new influence for SVC, injecting cash into the club so it can recover.
	# '''Letting influencers raise SVC.''' Even healthy clubs can benefit from a fundraise — influencers can propose and vote for a fundraise to raise funds for transfers, wages, or other expenses~~. It is also a safeguard against "lost keys": if a club becomes unmanaged or locked, the end-of-season fundraise proposal ensures it is not permanently lost~~.		# '''Letting influencers raise SVC.''' Even healthy clubs can benefit from a fundraise — influencers can propose and vote for a fundraise to raise funds for transfers, wages, or other expenses.

	== The Lifecycle of a Fundraise ==		== The Lifecycle of a Fundraise ==
Line 18:		Line 18:
	==== A. End-of-Season (Automatic) ====		==== A. End-of-Season (Automatic) ====

	At the end of each season, '''every club''' automatically gets a fundraise proposal or event:		At the end of each season, '''every club in debt''' automatically gets a fundraise proposal or event:

	* If the club is '''not in debt''', a '''proposal''' is created. Influencers vote on whether to accept the fundraise.
	* If the club is '''in debt''', the fundraise '''bypasses voting entirely''' — a fundraise event is created immediately and goes straight to the contribution phase.		* If the club is '''in debt''', the fundraise '''bypasses voting entirely''' — a fundraise event is created immediately and goes straight to the contribution phase.

	The amount of new influence to be created is calculated as a percentage (basis points) of the club's current outstanding influence, configured by the <code>seasonend-dilution-bp</code> parameter. The minimum raise is zero.		The amount of new influence to be created is calculated as a percentage (basis points) of the club's current outstanding influence, currently 5% (configured by the <code>seasonend-dilution-bp</code> parameter). The minimum raise is zero.

	==== B. User-Proposed (Influencer Initiative) ====		==== B. User-Proposed (Influencer Initiative) ====
Line 29:		Line 28:
	Any influencer can propose a fundraise if they meet two requirements:		Any influencer can propose a fundraise if they meet two requirements:

	* They must own at least a certain '''relative percentage''' of all outstanding club influence (configured by the <code>dilution-min-bps</code> parameter~~, e.g. 5%~~).		* They must own at least a certain '''relative percentage''' of all outstanding club influence, currently 5% (configured by the <code>dilution-min-bps</code> parameter).
	* Enough time must have passed since the '''last user-proposed fundraise vote''' for that club (configured by <code>min-seconds-between-dilution-votes</code>).		* Enough time must have passed since the '''last user-proposed fundraise vote''' for that club, currently 70 days (configured by <code>min-seconds-between-dilution-votes</code>).

	The proposing influencer specifies:		The proposing influencer specifies:

	* '''<code>n</code>''': How much new influence to create (between 1 and a maximum, which is a percentage of outstanding influence configured by <code>dilution-max-bps</code>).		* '''<code>n</code>''': How much new influence to create, between 1 and a maximum, which is a percentage of outstanding influence, currently 20% (configured by <code>dilution-max-bps</code>).
	* '''<code>mr</code>''' (minimum raise): The minimum amount of SVC that must be raised. If the total contributions fall short of this, the fundraise fails and all SVC is refunded.		* '''<code>mr</code>''' (minimum raise): The minimum amount of SVC that must be raised. If the total contributions fall short of this, the fundraise fails and all SVC is refunded.

Line 41:		Line 40:
	When a user proposes a fundraise, it goes through a '''governance proposal''' lifecycle:		When a user proposes a fundraise, it goes through a '''governance proposal''' lifecycle:

	* '''Upcoming phase''': The proposal is created but voting hasn't started yet. During this time, the proposer (or any other eligible influencer) can '''amend''' the proposal by adding more fundraise options (different <code>n</code> and <code>mr</code> combinations). The upcoming phase lasts for <code>dilution-upcoming-seconds</code>.		* '''Upcoming phase''': The proposal is created but voting hasn't started yet. During this time, the proposer (or any other eligible influencer) can '''amend''' the proposal by adding more fundraise options (different <code>n</code> and <code>mr</code> combinations). The upcoming phase lasts for 7 days (configured by<code>dilution-upcoming-seconds</code>).
	* '''Voting phase''': After the upcoming phase, the proposal enters voting for <code>dilution-voting-seconds</code>. Influencers vote with their existing influence (1 influence = 1 vote). Once voting ends, the winning option is executed.		* '''Voting phase''': After the upcoming phase, the proposal enters voting for 7 days (configured by<code>dilution-voting-seconds</code>). Influencers vote with their existing influence (1 influence = 1 vote). Once voting ends, the winning option is executed.
	* '''The ballot''': Every fundraise proposal has a '''"do nothing"''' option (~~option 0 for user proposals, option 1 for~~ end-of-season ~~proposals~~). If the winning option is "do nothing", no fundraise event is created.		* '''The ballot''': Every fundraise proposal has a '''"do nothing"''' option (unless created by an end-of-season proposal). If the winning option is "do nothing", no fundraise event is created.

	~~For end-of-season proposals, the default option (option 0) is the fundraise itself, meaning it passes unless influencers actively vote it down~~.

	=== 3. The Fundraise Event (Contribution Phase) ===		=== 3. The Fundraise Event (Contribution Phase) ===
Line 53:		Line 50:
	* A '''number of new influence''' to be created.		* A '''number of new influence''' to be created.
	* A '''minimum raise''' amount (0 for end-of-season fundraises; set by the proposer for user-proposed ones).		* A '''minimum raise''' amount (0 for end-of-season fundraises; set by the proposer for user-proposed ones).
	* An '''end time''', calculated as <code>current_time + dilution-seconds</code>.		* An '''end time''', calculated as <code>current_time + dilution-seconds</code>. The end time is currently set at 28 days (configured by <code>dilution-seconds</code>).

	During this phase, '''any user''' can contribute SVC to the event. They send a move with:		During this phase, '''any user''' can contribute SVC to the event. They send a move with:
Line 92:		Line 89:

	{\| class="wikitable"		{\| class="wikitable"
	! Parameter !! Description		! Parameter !! Description !! Current value
	\|-		\|-
	\| <code>dilutions-enabled</code> \|\| Master switch (0 = off, 1 = on)		\| <code>dilutions-enabled</code> \|\| Master switch (0 = off, 1 = on) \|\| 1
	\|-		\|-
	\| <code>dilution-min-bps</code> \|\| Minimum influence holding (in basis points) required to propose a fundraise		\| <code>dilution-min-bps</code> \|\| Minimum influence holding (in basis points) required to propose a fundraise \|\| 500
	\|-		\|-
	\| <code>dilution-max-bps</code> \|\| Maximum new influence as basis points of outstanding supply		\| <code>dilution-max-bps</code> \|\| Maximum new influence as basis points of outstanding supply \|\| 2000
	\|-		\|-
	\| <code>dilution-upcoming-seconds</code> \|\| Duration of the "upcoming" (amendable) phase		\| <code>dilution-upcoming-seconds</code> \|\| Duration of the "upcoming" (amendable) phase \|\| 7 * days
	\|-		\|-
	\| <code>dilution-voting-seconds</code> \|\| Duration of the voting phase		\| <code>dilution-voting-seconds</code> \|\| Duration of the voting phase \|\| 7 * days
	\|-		\|-
	\| <code>dilution-seconds</code> \|\| Duration of the contribution window		\| <code>dilution-seconds</code> \|\| Duration of the contribution window \|\| 28 * days
	\|-		\|-
	\| <code>min-seconds-between-dilution-votes</code> \|\| Cooldown between user-proposed fundraise votes per club		\| <code>min-seconds-between-dilution-votes</code> \|\| Cooldown between user-proposed fundraise votes per club \|\| 70 * days
	\|-		\|-
	\| <code>seasonend-dilution-bp</code> \|\| New influence to create at season end, as basis points of outstanding		\| <code>seasonend-dilution-bp</code> \|\| New influence to create at season end, as basis points of outstanding \|\| 500
	\|}		\|}