channel

package
v0.0.13 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 6, 2025 License: MIT Imports: 32 Imported by: 3

Documentation

Index

Constants

View Source 
const (
	// Byte 1 (bits 0..7)
	BuffWeaponAttack  = 0
	BuffWeaponDefense = 1
	BuffMagicAttack   = 2
	BuffMagicDefense  = 3

	BuffAccuracy     = 4
	BuffAvoidability = 5
	BuffHands        = 6
	BuffSpeed        = 7

	// Byte 2 (bits 8..15)
	BuffJump       = 8
	BuffMagicGuard = 9
	BuffDarkSight  = 10
	BuffBooster    = 11
	BuffPowerGuard = 12
	BuffMaxHP      = 13
	BuffMaxMP      = 14
	BuffInvincible = 15

	// Byte 3 (bits 16..23)
	BuffSoulArrow   = 16
	BuffStun        = 17
	BuffPoison      = 18
	BuffSeal        = 19
	BuffDarkness    = 20
	BuffComboAttack = 21
	BuffCharges     = 22
	BuffDragonBlood = 23

	// Byte 4 (bits 24..31)
	BuffHolySymbol       = 24
	BuffMesoUP           = 25
	BuffShadowPartner    = 26
	BuffPickPocketMesoUP = 27
	BuffMesoGuard        = 28
	BuffThaw             = 29
	BuffWeakness         = 30
	BuffCurse            = 31
)

BuffValueTypes now represent bit positions, not bitmasks.

View Source 
const (
	Ver_1  = 32
	Ver_14 = 64

	Default = Ver_14 // Most common versions used are UINT128.
)

Version/collection bit lengths

Variables

This section is empty.

Functions

func AddSkillBuff 

func AddSkillBuff(skillID int32, bits ...int)

AddSkillBuff registers one or more Flag bit positions for a skill.

func LoadBuffs 

func LoadBuffs()

LoadBuffs seeds known skill -> buff bit mappings.

func NewCharacterBuffs 

func NewCharacterBuffs(p *Player)

func StopSaver 

func StopSaver()

Types

type BuffSnapshot 

type BuffSnapshot struct {
	SourceID    int32 // skillID or -itemID
	Level       byte  // 0 for Item buffs
	ExpiresAtMs int64 // 0 for toggles/indefinite
}

type CharacterBuffs 

type CharacterBuffs struct {
	// contains filtered or unexported fields
}

func (*CharacterBuffs) AddBuff 

func (cb *CharacterBuffs) AddBuff(charId, skillID int32, level byte, foreign bool, delay int16)

func (*CharacterBuffs) AddBuffFromCC 

func (cb *CharacterBuffs) AddBuffFromCC(charId, skillID int32, expiresAtMs int64, level byte, foreign bool, delay int16)

func (*CharacterBuffs) AddItemBuff 

func (cb *CharacterBuffs) AddItemBuff(it Item)

durationSec is the client-visible remaining time in seconds. Source ID is encoded as -Item.ID.

func (*CharacterBuffs) AddItemBuffFromCC 

func (cb *CharacterBuffs) AddItemBuffFromCC(itemID int32, expiresAtMs int64)

func (*CharacterBuffs) AddMobDebuff 

func (cb *CharacterBuffs) AddMobDebuff(skillID, level byte, durationSec int16)

AddMobDebuff applies a debuff from a mob skill to the player

func (*CharacterBuffs) AuditAndExpireStaleBuffs 

func (cb *CharacterBuffs) AuditAndExpireStaleBuffs()

func (*CharacterBuffs) ClearBuff 

func (cb *CharacterBuffs) ClearBuff(skillID int32, _ uint32)

ClearBuff removes a specific buff from Player and DB.

func (*CharacterBuffs) HasGMHide 

func (cb *CharacterBuffs) HasGMHide() bool

func (*CharacterBuffs) RestoreFromSnapshot 

func (cb *CharacterBuffs) RestoreFromSnapshot(snaps []BuffSnapshot)

func (*CharacterBuffs) Snapshot 

func (cb *CharacterBuffs) Snapshot() []BuffSnapshot

type DirtyBits 

type DirtyBits uint64

DirtyBits mark which character columns need persisting. 

const (
	DirtyAP DirtyBits = 1 << iota
	DirtySP
	DirtyMesos
	DirtyHP
	DirtyMP
	DirtyMaxHP
	DirtyMaxMP
	DirtyEXP
	DirtyMap
	DirtyPrevMap
	DirtyJob
	DirtyLevel
	DirtyStr
	DirtyDex
	DirtyInt
	DirtyLuk
	DirtyFame
	DirtyInvSlotSizes
	DirtyMiniGame
	DirtyBuddySize
	DirtySkills
	DirtyNX
	DirtyMaplePoints
	DirtyPet
)

type Flag 

type Flag []uint32

Flag is a bitset stored as 32-bit words (most significant bits at lower indices).

func NewFlag 

func NewFlag() *Flag

NewFlag returns a flag with Default bits (64).

func NewFlagBits 

func NewFlagBits(uBits int) *Flag

NewFlagBits constructs a Flag with exactly uBits capacity.

func (*Flag) Data 

func (f *Flag) Data() []uint32

Data returns the internal data slice (do not modify).

func (*Flag) IsZero 

func (f *Flag) IsZero() bool

IsZero reports whether all bits are zero (or the flag has no words).

func (*Flag) SetBitNumber 

func (f *Flag) SetBitNumber(uBit int, uValue int)

SetBitNumber sets a specific bit to 0 or 1. Bits are addressed MSB-first per 32-bit word.

func (*Flag) SetValue 

func (f *Flag) SetValue(uValue uint32)

SetValue assigns a scalar 32-bit value to the least significant word, zeroing all higher words (mirrors Java).

func (*Flag) ToByteArray 

func (f *Flag) ToByteArray(bNewVer bool) []byte

ToByteArray returns the byte representation identical to the Java code. If bNewVer is false, it writes bytes in a "reverse fill" big-endian order across the entire array (matching Java's decrementing uLen fill). If bNewVer is true, it writes each 32-bit word in little-endian order, from last word to first.

func (*Flag) ToByteArrayEx 

func (f *Flag) ToByteArrayEx() []byte

ToByteArrayEx is the "reverse" of ToByteArray: it outputs per-word little-endian bytes, iterating from the end towards the beginning.

type Item 

type Item struct {
	ID int32
	// contains filtered or unexported fields
}

func CreateItemFromID 

func CreateItemFromID(id int32, amount int16) (Item, error)

func (Item) InventoryBytes 

func (v Item) InventoryBytes() []byte

InventoryBytes to display in character inventory window

type Player 

type Player struct {
	Conn mnet.Client

	ID int32 // Unique identifier of the character

	ChannelID byte

	Name string

	UpdatePartyInfo updatePartyInfoFunc
	// contains filtered or unexported fields
}

func LoadPlayerFromID 

func LoadPlayerFromID(id int32, conn mnet.Client) Player

func (*Player) FlushNow 

func (d *Player) FlushNow()

func (*Player) GetAccountName 

func (d *Player) GetAccountName() string

func (*Player) GetMaplePoints 

func (d *Player) GetMaplePoints() int32

func (*Player) GetNX 

func (d *Player) GetNX() int32

func (*Player) GiveItem 

func (d *Player) GiveItem(newItem Item) (error, Item)

GiveItem grants the given item to a player and returns the item

func (Player) Logout 

func (d Player) Logout()

Logout flushes coalesced state and does a full checkpoint save.

func (*Player) MarkDirty 

func (d *Player) MarkDirty(bits DirtyBits, debounce time.Duration)

Helper: mark dirty and schedule debounced save.

func (*Player) SeedRNGDeterministic 

func (d *Player) SeedRNGDeterministic()

SeedRNGDeterministic seeds the per-Player RNG using stable identifiers so gain sequences are reproducible across restarts and processes.

func (*Player) Send 

func (d *Player) Send(packet mpacket.Packet)

Send the Data a packet

func (*Player) SetMaplePoints 

func (d *Player) SetMaplePoints(points int32)

func (*Player) SetNX 

func (d *Player) SetNX(nx int32)

func (*Player) SetPos 

func (d *Player) SetPos(pos pos)

SetPos of Data

func (*Player) UpdateMovement 

func (d *Player) UpdateMovement(frag movementFrag)

UpdateMovement - update Data from position data

func (*Player) WriteCharacterInfoPacket 

func (plr *Player) WriteCharacterInfoPacket(p *mpacket.Packet)

type Players added in v0.0.5 

type Players struct {
	// contains filtered or unexported fields
}

func NewPlayers added in v0.0.5 

func NewPlayers() Players

func (*Players) Add added in v0.0.5 

func (p *Players) Add(plr *Player)

func (Players) Flush added in v0.0.5 

func (p Players) Flush()

func (Players) GetFromConn added in v0.0.5 

func (p Players) GetFromConn(conn mnet.Client) (*Player, error)

func (Players) GetFromID added in v0.0.5 

func (p Players) GetFromID(id int32) (*Player, error)

func (Players) GetFromName added in v0.0.5 

func (p Players) GetFromName(name string) (*Player, error)

func (*Players) RemoveFromConn added in v0.0.5 

func (p *Players) RemoveFromConn(conn mnet.Client) error

type Server 

type Server struct {
	// contains filtered or unexported fields
}

Server state

func (*Server) CheckpointAll 

func (server *Server) CheckpointAll()

CheckpointAll now uses the saver to flush debounced/coalesced deltas for every Player.

func (*Server) ClientDisconnected 

func (server *Server) ClientDisconnected(conn mnet.Client)

ClientDisconnected from server

func (*Server) HandleClientPacket 

func (server *Server) HandleClientPacket(conn mnet.Client, reader mpacket.Reader)

func (*Server) HandleServerPacket 

func (server *Server) HandleServerPacket(conn mnet.Server, reader mpacket.Reader)

func (*Server) Initialise 

func (server *Server) Initialise(work chan func(), dbuser, dbpassword, dbaddress, dbport, dbdatabase, dropsJson, reactorJson, reactorDropsJson string)

Initialise the server

func (*Server) RegisterWithWorld 

func (server *Server) RegisterWithWorld(conn mnet.Server, ip []byte, port int16, maxPop int16)

RegisterWithWorld server

func (*Server) SendCountdownToPlayers 

func (server *Server) SendCountdownToPlayers(t int32)

SendCountdownToPlayers - Send a countdown to players that appears as a clock

func (*Server) SendLostWorldConnectionMessage 

func (server *Server) SendLostWorldConnectionMessage()

SendLostWorldConnectionMessage - Send message to players alerting them of whatever they do it won't be saved

func (*Server) StartAutosave 

func (server *Server) StartAutosave(ctx context.Context)

startAutosave periodically flushes deltas via the saver.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.