Disclaimer

Only use this if you know what you are doing. With Client Secret anyone could get access to your campaign info, all of your patrons' profile info, email addresses, and their pledge amounts

For production, it would be better to have a dedicated server to handle authorisation.

Setup

First, you need to create a client on Patreon.

Go to the https://www.patreon.com/portal/registration/register-clients and click on the "Create Client" button.

• App Name — enter your game name
• Description — enter some text. It will displayed to the user on authentication  page.
• App Category — Select something
• Redirect URIs — enter http://localhost:6167/auth
• Client API Version — should be 2
• Other fields are not required.

You only need 2 fields "Client ID" and "Client Secret" from the newly created client.

Somewhere in your game (for example, in the "options.rpy") write this code:

define PATREON_CLIENT_ID = "<YOUR_CLIENT_ID>"
define PATREON_CLIENT_SECRET = "<YOUR_CLIENT_SECRET>"

Replace the "<YOUR_CLIENT_ID>" with your Client ID value and
"<YOUR_CLIENT_SECRET>" with your Client Secret value.

From the archive that you downloaded from itch, you'll need 4 files inside the "patreon_auth" folder. Extract this folder inside your game folder (i.e ("MyGame/game/patreon_auth")

Now somewhere in the game you can use this action to start auth process:

PatreonAuth(PATREON_CLIENT_ID, PATREON_CLIENT_SECRET, "/auth")

For example:

textbutton _("Auth with Patreon") action PatreonAuth(PATREON_CLIENT_ID, PATREON_CLIENT_SECRET, "/auth")

By default, user info are saved inside persistent.PATREON_USER_DATA variable.

For example, to get user name:

persistent.PATREON_USER_DATA.get("data").get("attributes").get("full_name")

More info about other fields here: https://docs.patreon.com/#user-v2.

Scopes

Some info are not sent from Patreon by default. To get it, you need to edit scopes inside the "patreon_auth/PatreonAuth.rpy" file.

For example, to get user email, update the scope parameter to this:
scope = "identity identity[email]".

Also, you need to update requested fields inside the on_success_auth function. Add "email" to the "fields[user]" field:

user = client.get_user_data({"fields[user]": "full_name,image_url,email"...

More info about scopes here https://docs.patreon.com/#scopes

How to tell if a player is subscribed

Something like this should work:

included = persistent.PATREON_USER_DATA.get("included")
if len(included) > 0:
  attributes = included[0].get("attributes", {})
  patron_status = attributes.get("patron_status")
  amount = attributes.get("currently_entitled_amount_cents")

patron_status variable could be one of those: active_patron, declined_patron, former_patron or None (if user never pledged).

More info here: https://docs.patreon.com/#member

Update user info

To update user info, you can use something like this (not tested):

client = PatreonClient(persistent.PATREON_TOKENS.get("access_token"))
# fields may vary, depending on your needs
user = client.get_user_data({"fields[user]": "full_name,image_url", "include": "memberships", "fields[member]": "patron_status,currently_entitled_amount_cents"})
persistent.PATREON_USER_DATA = user
renpy.restart_interaction()

Expiration

After a month Patreon tokens will expire and you won't be able to update user info.

You'll need to either manually refresh the tokens (see https://docs.patreon.com/#step-7-keeping-up-to-date) or ask the player to sign in via Patreon again.

return "http://localhost:" + str(webserver.PORT) + self.callback_url

return "http://127.0.0.1:" + str(webserver.PORT) + self.callback_url