Configuration

Configuration

NeoForge: generated at config/crazyphone-common.toml on first run. Every *FeatureEnabled value below can also be changed at runtime with /crazyphone feature, without editing the file or restarting - see Commands.

Fabric: the same settings exist as compiled-in defaults (shown below) - not yet exposed as an editable file or via /crazyphone feature. Config.java is built entirely on NeoForge's ModConfigSpec, which has no Fabric equivalent; Fabric needs its own config system (a JSON file, or a library like Cloth Config) before these can persist or be runtime-toggleable there.

Option	Default	Range	Description
maxStoredMessagesPerConversation	300	10-10000	Messages kept on disk per conversation; oldest dropped first once exceeded.
maxMessagesSentPerRequest	100	10-1000	Messages sent to a client in one page load of a conversation.
maxImagesStoredPerConversation	50	5-2000	Image messages kept on disk per conversation (capped separately - heaviest text-adjacent payload).
maxPhotosStoredPerOwner	300	10-5000	Photos (both resolutions) kept on disk per owning phone number; oldest dropped first once exceeded, independent of conversation trimming.
mayorElectionFeatureEnabled	true	-	Global switch for the mayor election feature.
callsFeatureEnabled	true	-	Global switch for voice calls. No effect without Simple Voice Chat installed. (NeoForge only)
voiceMessagesFeatureEnabled	true	-	Global switch for recording/sending voice messages. No effect without Simple Voice Chat installed. (NeoForge only)
imagesFeatureEnabled	true	-	Global switch for sending images into a conversation.
voicechatIntegrationEnabled	true	-	Master switch for the whole Simple Voice Chat integration (both calls and voice messages). (NeoForge only)
callRingTimeoutSeconds	30	5-120	How long a call rings before an unanswered callee counts as a missed call. (NeoForge only)
aloneInCallKickSeconds	5	1-60	How long a call stays open with one participant left before they're auto-removed. (NeoForge only)
maxVoiceMessagesStoredPerConversation	30	5-500	Voice messages (with audio) kept on disk per conversation. (NeoForge only)
maxVoiceMessageRecordingSeconds	60	5-600	Maximum length of a single voice message recording. (NeoForge only)
soulboundEnchantmentEnabled	true	-	Whether the Soulbound enchantment actually keeps enchanted items on death.

Permissions

(NeoForge only for now) Each toggleable feature also has a permission node (crazyphone.feature.<calls|voice_messages|images|mayor_voting>), for restricting a feature to specific players/groups instead of the whole server. Allowed for everyone by default; only takes effect if a permission plugin (e.g. LuckPerms) is installed. A feature is usable only when both its global switch is on and the player has the permission - neither check replaces the other.